mmdb-server v1.2 released

Release Notes - v1.2 (2025-12-22)

This release introduces containerization support, modernizes dependency management, and includes several data and stability improvements.

🚀 New Features

• Docker Support: Added a Dockerfile for containerized deployments and included relevant documentation.
• Source IP Endpoint: Added a new /raw endpoint that returns the source IP address (supports GET and HEAD requests).

🛠 Improvements

• Database Updates: Multiple updates to the latest versions of the GeoOpen and MMDB database files.
• Dependency Management: Migrated the project from standard requirements to Poetry for better environment handling.
• Configuration: Updated the sample configuration to use relative paths for better portability.
• Optimization: Core files optimized and cleaned of unused dictionaries and empty structures.

🐛 Bug Fixes

• Resolved issues related to FileNotFoundError during execution.
• Improved general stability through code cleanup and pull request integrations.

mmdb-server version 1.1 released including minor bugs fixed

mmdb-server is an open source fast API server to lookup IP addresses for their geographic location, AS number. The server can be used with any MaxMind DB File Format or file in the same format. The server includes the open and free Geo Open - IP address geolocation per country in MMDB format 🗺️.

This version fixes a small bug with the lookup of unknown countries and include an update of the free Geo Open database.

For more and details.

mmdb-server v1.0 released - an open source fast API server to lookup IP addresses for their geographic location.

mmdb-server v1.0 released - an open source fast API server to lookup IP addresses for their geographic location. The server reached version 1.0 as many production servers are running flawlessly with this code. mmdb-server includes the geo-open database from CIRCL.

mmdb-server (the open and free geo IP server) version 0.5 released

mmdb-server (the open and free geo IP server) version 0.5 released (2022-02-06) 🗺️

mmdb-server (the open and free geo IP server) version 0.5 released which includes the support for to load multiple MMDB files.

A new GeoOpen database included to support AS number and AS description lookup.

New

• [multiple MMDB file support] MMDB server can now load a list of MMDB files + new GeoOpen file including ASN details added as example. [Alexandre Dulaunoy]

  GeoOpen files for country only -> https://cra.circl.lu/opendata/geo-open/mmdb-country/
  GeoOpen files with country and ASN/ASN description -> https://cra.circl.lu/opendata/geo-open/mmdb-country-asn/

• [db] Country-ASN db added. [Alexandre Dulaunoy]

• [db] GeoOpen database updated. [Alexandre Dulaunoy]

Changes

• [doc] update the documentation and examples with the multiple sources. [Alexandre Dulaunoy]

• [log] remove old debug. [Alexandre Dulaunoy]

• [db] renamed. [Alexandre Dulaunoy]

• [GeoOpen-country] updated. [Alexandre Dulaunoy]

Other

• Update README.md. [Alexandre Dulaunoy]

🗺️ mmdb-server v0.2 relase - an open source fast API server to lookup IP addresses for their geographic location

What's new in v0.2 (2022-01-24)

New

• [server] Add additional information about the country including average location, complete name and numeric code. [Alexandre Dulaunoy]

• [mygeolookup] Query on root of the server will give the geo location of the remote IP address doing the query. [Alexandre Dulaunoy]

Changes

• [doc] update JSON output and CIRCL public service. [Alexandre Dulaunoy]

• [server] display port. [Alexandre Dulaunoy]

• [server] make port configurable. [Alexandre Dulaunoy]

🗺️ mmdb-server v0.1 - an open source fast API server to lookup IP addresses for their geographic location

mmdb-server is an open source fast API server to lookup IP addresses for their geographic location. The server can be used with any MaxMind DB File Format or file in the same
format.

mmdb-server includes a free and open GeoOpen-Country database for IPv4 and IPv6 addresses. The file GeoOpen-Country is generated on a regular basis from AS announces and their respective whois records.

Installation

Python 3.8+ is required to run the mmdb-server with some additional requirements.

• pip3 install -r REQUIREMENTS
• cp ./etc/server.conf.sample ./etc/server.conf
• cd bin; python3 server.py

Usage

Lookup of an IP address

curl -s http://127.0.0.1:8000/geolookup/188.65.220.25 | jq .

[
  {
    "country": {
      "iso_code": "BE"
    },
    "meta": {
      "description": {
        "en": "Geo Open MMDB database - https://github.com/adulau/mmdb-server"
      },
      "build_db": "2022-01-23 16:13:05",
      "db_source": "GeoOpen-Country",
      "nb_nodes": 1156125
    }
  }
]

$ curl -s http://127.0.0.1:8000/geolookup/2a02:21d0::68:69:25 | jq .

[
  {
    "country": {
      "iso_code": "BE"
    },
    "meta": {
      "description": {
        "en": "Geo Open MMDB database - https://github.com/adulau/mmdb-server"
      },
      "build_db": "2022-01-23 16:13:05",
      "db_source": "GeoOpen-Country",
      "nb_nodes": 1156125
    }
  }
]

Output format

The output format is an array of JSON object (to support the ability to serve multiple geo location database). Each JSON object of the JSON array includes a meta and a country fields. The country give the geo
graphic location of the IP address queried. The meta field includes the origin of the MMDB database which the the metadata.