mmdblookup(1)

💖 mmdblookup — the girlies' guide to looking up IPs 💖

okay so bestie, this is mmdblookup, a utility from the General Commands Manual section 1, and she's here to look up an IP address in a MaxMind DB file. no cap, she's tiny but she ATE. 🦋

---

✨ NAME ✨

mmdblookup — a utility to look up an IP address in a MaxMind DB file

---

🌸 SYNOPSIS 🌸

mmdblookup --file [FILE PATH] --ip [IP ADDRESS] [DATA PATH]

like that's literally it. that's the whole vibe. 💅

---

👑 DESCRIPTION 👑

mmdblookup looks up an IP address in the specified MaxMind DB file. the record for that IP gets displayed, and it uses {} to denote maps and [] to denote arrays — so you can see the shape of the data. the values are followed by type annotations too.

⚠️ heads up bestie: this output is not JSON and is not intended to be used as such. if you need JSON, please see mmdbinspect. i'm being so serious. 🙈

if an IP's data entry resolves to a map or array, you can provide a lookup path to only show part of that data. it's giving "i don't need the whole fit, just the shoes". ✨

for example, given a JSON structure like this:

{
    "names": {
        "en": "Germany",
        "de": "Deutschland"
    },
    "cities": [ "Berlin", "Frankfurt" ]
}

you could look up just the English name by calling mmdblookup with a lookup path of:

mmdblookup --file ... --ip ... names en

or you could look up the second city in the list with:

mmdblookup --file ... --ip ... cities 1

array numbering begins with zero (0) — zero-indexed, we love a programmer-girl moment. 🎀

and if you do not provide a path to lookup, all of the information for a given IP will be shown. the whole entire thing. main character energy. 🌈

---

💅 OPTIONS 💅

this application accepts the following options:

• -f, --file — the path to the MMDB file. Required. like, you literally cannot skip this one.
• -i, --ip — the IP address to look up. Required. also non-negotiable, bestie.
• -v, --verbose — turns on verbose output. specifically, this causes this application to output the database metadata. it's the behind-the-scenes lore drop. 🍓
• --version — print the program's version number and exit. short, sweet, iconic.
• -h, -?, --help — show usage information. she's helpful AND pretty.

---

🫶 BUG REPORTS AND PULL REQUESTS 🫶

please report all issues to our GitHub issue tracker. we welcome bug reports and pull requests. and ngl, please note that pull requests are greatly preferred over patches — that's the way that it is, iykyk. 💜

---

🧚 AUTHORS 🧚

this utility was written by Boris Zentner (bzentner@maxmind.com) and Dave Rolsky (drolsky@maxmind.com). two legends fr fr. 👑

---

⭐ COPYRIGHT AND LICENSE ⭐

Copyright 2013-2026 MaxMind, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

🫶 yeah so that's the legal bit and it's real, don't skip it, we must respect the license bestie.

---

🌈 SEE ALSO 🌈

• libmaxminddb(3) — go read her too, she's the whole foundation of this operation. 💖

---

and that's the page, babe 🎀 — it came to you straight from the General Commands Manual (that's the manual name, section 1 energy), and it's mmdblookup(1), living in the General Commands Manual forever and ever. now go look up some IPs and slay. 💅✨