MMDB CLI 🛠️

MMDB CLI is our first publicly available open-source project, developed to simplify working with MMDB files. It is a command-line tool that allows you to generate, modify, export, and inspect MMDB files, among other functionalities.

What is MMDB?

The MMDB (MaxMind Database) is a widely used database file format designed to map IPv4 and IPv6 addresses to specific data records through an efficient binary search tree structure. For more details, please refer to the MMDB File Format Specification.

Why MMDB CLI?

We’ve always wanted a comprehensive and easy-to-use tool for working with MMDB files. That’s why we developed MMDB CLI, to make handling MMDB files simple and efficient, without the need for coding.

With MMDB CLI, you can:

• Inspect records for one or more IPs/CIDRs
• Print database metadata in YAML or JSON
• Dump a full database into a JSON dataset
• Generate an MMDB file from a JSON dataset
• Update an existing MMDB file with merge/replace/remove methods
• Verify database integrity

The CLI binary name used throughout this documentation is mmdb-cli.

Table of Contents

• Installation
• Capabilities
• Building from Source
• Dataset Schema
• Commands:
  • Metadata
  • Inspect
  • Dump
  • Generate
  • Update
  • Verify

License

We have released MMDB CLI under the Apache License 2.0. You can access the source code and find more information in our GitHub repository.