Skip to content

Releases: IPGeolocation/mmdbio

v1.1.0 – Introducing the Import Command

11 Nov 09:36
fd911cc

Choose a tag to compare

mmdbio CLI - Release 1.1.0

Release Date: 2025-11-11
Version: 1.1.0


🆕 New Features

import command

  • Import JSON file and generate .mmdb databases.
  • Supports:
    • IPv4 and IPv6
    • Mixed IPv4/IPv6 JSON input
    • IP ranges, single IPs, and CIDRs
  • Flags:
    • --in, -i : Input JSON file path
    • --out, -o : Output .mmdb file path
    • --ip : IP version (4 or 6), default is 6
    • --size : Record size (24, 28, 32), default is 32
    • --merge : Merge strategy (none, toplevel, recurse), default -> none
    • --alias-6to4 : Enable IPv6 to IPv4 aliasing for hybrid databases, default (false)
    • --disallow-reserved : Skip reserved IP blocks, default (false)
    • --title : Custom title for the .mmdb database
    • --description : Custom description for the .mmdb database

Example Usage

# Import IPv4-only JSON
mmdbio import --in ipv4_export.json --out ipv4_data.mmdb --ip 4 --size 32

# Import IPv6-only JSON
mmdbio import --in ipv6_export.json --out ipv6_data.mmdb --ip 6

# Import mixed JSON (IPv4 + IPv6) with 6to4 aliasing
mmdbio import --in all_data.json --out all.mmdb --ip 6 --alias-6to4

# Import and skip reserved IP ranges
mmdbio import --in dataset.json --out filtered.mmdb --disallow-reserved

v1.0.0 - Initial Stable Release

10 Nov 10:36

Choose a tag to compare

MMDBIO CLI v1.0.0 Release Notes

Overview

mmdbio v1.0.0 is the first official release of the MMDB CLI tool. This tool allows users to work with MaxMind MMDB files including reading, exporting, comparing, inspecting, verifying, and viewing statistics.

Installation

Go install

go install github.com/IPGeolocation/mmdbio@v1.0.0

Build from Source

git clone https://github.com/IPGeolocation/mmdbio.git
cd mmdbio
go build -o mmdbio .

Prebuilt Binaries

Download binaries from GitHub Releases for Linux, macOS, and Windows. Rename and place in your PATH for easy usage.

Commands

  • read - Lookup IPs from MMDB files.
  • metadata - Show MMDB metadata.
  • export - Export MMDB to JSON.
  • diff - Compare two MMDB files.
  • inspect - Inspect structure and export schema.
  • stats - View statistics.
  • verify - Validate MMDB file.
  • completion - Generate shell completions.

Example Usage

mmdbio read --db GeoIP2-City.mmdb --ip 8.8.8.8 --fields location.country.name
mmdbio export --db GeoIP2-City.mmdb --out export.json
mmdbio diff --old old.mmdb --new new.mmdb --summary
mmdbio inspect --db GeoIP2-City.mmdb --out schema.json
mmdbio stats --db GeoIP2-City.mmdb --json
mmdbio verify --db GeoIP2-City.mmdb

Notes

  • Ensure $GOBIN or $GOPATH/bin is in your PATH.
  • Prebuilt binaries and shell completion scripts available in GitHub Releases.