ip-location-db - GitLite

KO | EN

gitlite — search

#typescript #llm #go #android #deep-learning #linux #macos #windows #awesome #vue #awesome-list #security #mcp #ios

ip-location-db

(★ 2,156)

ip to location database by ASN, GeoFeed, Whois, iptoasn.com, db-ip lite, GeoLite2

File Explorer

Download Latest Version (.zip)

- - rebase-bgp.yml
  - rebase-cache.yml
  - run-bgp.yml
  - run-src.yml
- - mmdb-create.yml
  - publish-mmdb-all.yml
  - rebase.yml
- dbip-asn-ipv4.csv
- dbip-asn-ipv6.csv
- DBIP-LICENSE
- package.json
- DBIP-LICENSE
- package.json
- dbip-country-ipv4.csv
- dbip-country-ipv6.csv
- DBIP-LICENSE
- package.json
- geolite2-asn-ipv4.csv
- geolite2-asn-ipv6.csv
- GEOLITE2_EULA
- GEOLITE2_LICENSE
- package.json
- GEOLITE2_EULA
- GEOLITE2_LICENSE
- package.json
- geolite2-country-ipv4.csv
- geolite2-country-ipv6.csv
- GEOLITE2_EULA
- GEOLITE2_LICENSE
- package.json
- package.json
- package.json
- origin-asn-ipv4.csv
- origin-asn-ipv6.csv
- package.json
- SOURCES.md
- package.json
- server-country-ipv4.csv
- server-country-ipv6.csv
- SOURCES.md
- - copy-package-readme.js
  - create-all-mmdb.sh
  - create-mmdb-dir.js
  - create-mmdb.js
  - create-readme.js
  - DATA.md
  - ip-range.js
  - publish-mmdb.sh
  - README.tpl.md
- commit.sh
- create-mmdb.js
- package.json
- SOURCES.md
- user-country-ipv4.csv
- user-country-ipv6.csv
.editorconfig
.gitattributes
.gitignore
CHANGELOG.md
README.md

🚀 Installation Guide

1. Get the code

git clone https://github.com/sapics/ip-location-db

Downloads the entire project code from GitHub to your computer.

cd ip-location-db

Moves into the project folder you just downloaded.

2. Node.js

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

cd dbip-asn

This project's files live in a subfolder, so move into it first.

npm install

Downloads and installs the libraries listed in package.json.

npm start

Starts the development/run server.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ip-location-db

This project provides IP to location databases in CSV and MMDB formats since 2019.

⚠️ As of June 18, 2026, we have revised our distribution method for [GitHub Releases](https://github.com/sapics/ip-location-db/releases/tag/latest). Please update your URLs accordingly.

There are 3 types of IP database in this repository: `country`, `city` and `asn` files. All have their own standard format.

### Country

```CSV
ip_range_start, ip_range_end, country_code
```

| Database | License | Updated | IPv4 | IPv6 | IPv4+IPV6 | IPv4-num | IPv6-num | IPv4-CIDR | IPv6-CIDR |
|---|---|---|---|---|---|---|---|---|---|
| [user-country](https://github.com/sapics/ip-location-db/tree/main/user-country/) | [PDDL](https://opendatacommons.org/licenses/pddl/1-0/) | Daily | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/user-country-ipv4.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/user-country-ipv4.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/user-country-ipv6.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/user-country-ipv6.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/user-country.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/user-country.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/user-country-ipv4-num.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/user-country-ipv6-num.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/user-country-ipv4-cidr.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/user-country-ipv6-cidr.csv) |
| [server-country](https://github.com/sapics/ip-location-db/tree/main/server-country/) | [PDDL](https://opendatacommons.org/licenses/pddl/1-0/) | Daily | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/server-country-ipv4.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/server-country-ipv4.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/server-country-ipv6.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/server-country-ipv6.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/server-country.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/server-country.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/server-country-ipv4-num.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/server-country-ipv6-num.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/server-country-ipv4-cidr.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/server-country-ipv6-cidr.csv) |
| [GeoLite2](https://github.com/sapics/ip-location-db/tree/main/geolite2-country/) | GeoLite2 License by [MaxMind](https://www.maxmind.com/) | Twice weekly | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-country-ipv4.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-country-ipv4.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-country-ipv6.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-country-ipv6.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-country.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-country.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-country-ipv4-num.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-country-ipv6-num.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-country-ipv4-cidr.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-country-ipv6-cidr.csv) |
| [DB-IP Lite](https://github.com/sapics/ip-location-db/tree/main/dbip-country/) | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) <br> by [DB-IP](https://db-ip.com/) | Monthly | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-country-ipv4.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-country-ipv4.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-country-ipv6.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-country-ipv6.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-country.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-country.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-country-ipv4-num.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-country-ipv6-num.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-country-ipv4-cidr.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-country-ipv6-cidr.csv) |
| [IPtoASN](https://github.com/sapics/ip-location-db/tree/main/iptoasn-country/) | [PDDL](https://opendatacommons.org/licenses/pddl/1-0/) | Daily | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-country-ipv4.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-country-ipv4.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-country-ipv6.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-country-ipv6.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-country.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-country.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-country-ipv4-num.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-country-ipv6-num.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-country-ipv4-cidr.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-country-ipv6-cidr.csv) |

### City

```CSV
ip_range_start, ip_range_end, country_code, state1, state2, city, postcode, latitude, longitude, timezone
```

| Database | License | Updated | IPv4 | IPv6 | IPv4-num | IPv6-num |
|---|---|---|---|---|---|---|
| [DB-IP Lite](https://github.com/sapics/ip-location-db/tree/main/dbip-city/) | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)<br>by [DB-IP](https://db-ip.com/) | Monthly | [CSV.gz](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-city-ipv4.gz)<br>[CSV.7z](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-city-ipv4.7z)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-city-ipv4.mmdb) | [CSV.gz](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-city-ipv6.gz)<br>[CSV.7z](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-city-ipv6.7z)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-city-ipv6.mmdb) | [CSV.gz](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-city-ipv4-num.gz)<br>[CSV.7z](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-city-ipv4-num.7z) | [CSV.gz](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-city-ipv6-num.gz)<br>[CSV.7z](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-city-ipv6-num.7z) |
| [GeoLite2](https://github.com/sapics/ip-location-db/tree/main/geolite2-city/) | GeoLite2 License by [MaxMind](https://www.maxmind.com/) | Twice weekly | [CSV.gz](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-city-ipv4.gz)<br>[CSV.7z](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-city-ipv4.7z)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-city-ipv4.mmdb) | [CSV.gz](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-city-ipv6.gz)<br>[CSV.7z](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-city-ipv6.7z)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-city-ipv6.mmdb) | [CSV.gz](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-city-ipv4-num.gz)<br>[CSV.7z](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-city-ipv4-num.7z) | [CSV.gz](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-city-ipv6-num.gz)<br>[CSV.7z](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-city-ipv6-num.7z) |

### ASN

```CSV
ip_range_start, ip_range_end, autonomous_system_number, autonomous_system_organization
```

| Database | License | Updated | IPv4 | IPv6 | IPv4+IPV6 | IPv4-num | IPv6-num | IPv4-CIDR | IPv6-CIDR |
|---|---|---|---|---|---|---|---|---|---|
| [origin-asn](https://github.com/sapics/ip-location-db/tree/main/origin-asn/) | [PDDL](https://opendatacommons.org/licenses/pddl/1-0/) | Daily | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/origin-asn-ipv4.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/origin-asn-ipv4.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/origin-asn-ipv6.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/origin-asn-ipv6.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/origin-asn.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/origin-asn.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/origin-asn-ipv4-num.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/origin-asn-ipv6-num.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/origin-asn-ipv4-cidr.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/origin-asn-ipv6-cidr.csv) |
| [GeoLite2](https://github.com/sapics/ip-location-db/tree/main/geolite2-asn/) | GeoLite2 License by [MaxMind](https://www.maxmind.com/) | Twice weekly | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-asn-ipv4.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-asn-ipv4.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-asn-ipv6.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-asn-ipv6.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-asn.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-asn.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-asn-ipv4-num.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-asn-ipv6-num.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-asn-ipv4-cidr.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/geolite2-asn-ipv6-cidr.csv) |
| [DB-IP Lite](https://github.com/sapics/ip-location-db/tree/main/dbip-asn/) | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) <br> by [DB-IP](https://db-ip.com/) | Monthly | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-asn-ipv4.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-asn-ipv4.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-asn-ipv6.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-asn-ipv6.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-asn.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-asn.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-asn-ipv4-num.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-asn-ipv6-num.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-asn-ipv4-cidr.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/dbip-asn-ipv6-cidr.csv) |
| [IPtoASN](https://github.com/sapics/ip-location-db/tree/main/iptoasn-asn/) | [PDDL](https://opendatacommons.org/licenses/pddl/1-0/) | Daily | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-asn-ipv4.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-asn-ipv4.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-asn-ipv6.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-asn-ipv6.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-asn.csv)<br>[MMDB](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-asn.mmdb) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-asn-ipv4-num.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-asn-ipv6-num.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-asn-ipv4-cidr.csv) | [CSV](https://github.com/sapics/ip-location-db/releases/download/latest/iptoasn-asn-ipv6-cidr.csv) |

### Checksums

SHA-256 checksum files for all release assets are available in the [Checksum Release](https://github.com/sapics/ip-location-db/releases/tag/checksum).

To get the checksum URL for a file, replace `/download/latest/` with `/download/checksum/` and append `.sha256` to the filename.

- File: [https://github.com/sapics/ip-location-db/releases/download/latest/user-country-ipv4.csv](https://github.com/sapics/ip-location-db/releases/download/latest/user-country-ipv4.csv)
- SHA-256: [https://github.com/sapics/ip-location-db/releases/download/checksum/user-country-ipv4.csv.sha256](https://github.com/sapics/ip-location-db/releases/download/checksum/user-country-ipv4.csv.sha256)

## Databases referenced in this project

### Original Databases [Update: Daily]

`user-country`, `server-country`, and `origin-asn` are published under the [Public Domain Dedication and License v1.0](https://opendatacommons.org/licenses/pddl/1.0/) (PDDL) (**free use without attribution**).

These datasets are compiled from raw, public network data. We aim to use sources free of commercial or redistribution restrictions to maintain this permissive licensing.

Huge thanks to the following organizations for providing the foundational data:

#### 1. Regional Internet Registries (RIRs) & NRO
We use public statistical data (e.g., delegated statistics) from the five Regional Internet Registries (AFRINIC, APNIC, ARIN, LACNIC, RIPE NCC) and the NRO.
* **License:** Subject to the [NRO License](https://www.nro.net/about/nro-policies/) and respective RIR copyright statements.

#### 2. Global BGP Routing Archives (Route Views & RIPE RIS)
We aggregate global BGP routing data (RIB dumps and BGP updates) to analyze network visibility and active IP prefixes using the two primary open routing archives:
* **[Route Views](http://www.routeviews.org/)** (University of Oregon)
* **[RIPE RIS](https://ris.ripe.net/)** (RIPE NCC)

#### 3. Geofeed Providers
We integrate geolocation data from `geofeeds` published by network operators worldwide (RFC 8805 / RFC 9632).
* **Note:** While geofeeds are intended for public use, many lack explicitly defined licenses. We use this data "as is" to compile our datasets.

---

#### Compliance & Data Handling Policy
To comply with data providers' Acceptable Use Policies (AUP) and maintain our PDDL licensing, we **DO NOT** use RIR WHOIS or IRR databases (e.g., `inetnum`, `country`, `geoloc`) for geographic mapping.

Many RIRs strictly prohibit this (e.g., [APNIC's AUP](https://www.apnic.net/manage-ip/using-whois/bulk-access/copyright/) states: *"you cannot use the database to map IP address to geographic location"*). By relying only on open routing records and public geofeeds, we keep our datasets compliant and safe for public use.

---

#### `user-country` vs. `server-country`
Both databases share the same data sources but prioritize different geographic points:

* **`user-country` (Recommended):** Prioritizes the end-user's country, even when routed through VPNs or proxies. Best for most general applications.
* **`server-country`:** Prioritizes the physical server or relay point. Best for specific network analysis (e.g., determining routing locations).

*(Note: Both databases return almost identical results in most instances.)*

### [IPtoASN](https://iptoasn.com/) database [Update: Hourly]

You can download hourly updated database in tsv format from [original site](https://iptoasn.com/).
This is licensed under a [Public Domain Dedication and License v1.0](https://opendatacommons.org/licenses/pddl/1.0/).

### [DB-IP](https://db-ip.com/) database [Update: Monthly]

You could download and read the license from [ip-to-asn-lite](https://db-ip.com/db/download/ip-to-asn-lite) or [ip-to-country-lite](https://db-ip.com/db/download/ip-to-country-lite) or [ip-to-city-lite](https://db-ip.com/db/download/ip-to-city-lite).

These database are licensed under a [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
In the case of a web application, you must include a link back to DB-IP.com on pages that display or use results from the database. You may do it by pasting the HTML code snippet into your code: `<a href='https://db-ip.com/'>IP Geolocation by DB-IP</a>`.<br>
If you need better accuracy or no attribution or daily updates, please use the [Commercial Version of db-ip](https://db-ip.com/db/ip-to-country).

### [GeoLite2](https://dev.maxmind.com/geoip/geoip2/geolite2/) database [Update: Twice weekly]

GeoLite2 is created by [MaxMind](https://www.maxmind.com).
The license of GeoLite2 is written in GEOLITE2_LICENSE and End User License Agreement (EULA) is written in GEOLITE2_EULA.
**Please carefully read the GEOLITE2_LICENSE and GEOLITE2_EULA files, if you use these database.**
This package comes with certain restrictions and obligations, most notably:
- You cannot prevent the library from updating the databases.
- You cannot use the GeoLite2 data:
  - for FCRA purposes,
  - to identify specific households or individuals.

You can read [the latest version of GeoLite2 EULA](https://www.maxmind.com/en/geolite2/eula).
GeoLite2 databse is provided under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) by [MaxMind](https://www.maxmind.com).
If you need better accuracy, please use the commercial version [GeoIp2](https://www.maxmind.com/en/geoip2-databases).

## Which database should I use?

It depends upon your use-case! We do have some simple recommendations though:

- If you need postcodes or timezones: `geolite2-city`
- If you need city data with a CC-BY Licence: `dbip-city`
- If you need a country database without attribution: `user-country`
- If you need an ASN database: `origin-asn`

## Accuracy of database

Since there is no definitive information on IP addresses and country_code, it is difficult to discuss the accuracy of our data qualitatively, but it is possible to estimate the approximate accuracy by comparing it with the country information in GeoLite2 and DbIp Lite.
By comparing the database in GeoLite2, which is well known for its high accuracy, with the differences in other databases, we can see that our data accuracy.

| Database | Same | Diff | Empty | Extra |
| ---- | ---- | ---- | ---- | ---- |
| user-country | 97.49% | 2.51% | 0.00% | 0.03% |
| dbip-country | 94.49% | 5.51% | 0.00% | 0.44% |
| iptoasn-country | 78.50% | 5.84% | 15.66% | 0.04% |

Measurements were taken in 14 June 2026.
Because the ipv6 range is too wide, the measurements here are limited to ipv4 results.
"Same" + "Diff" + "Empty" shows the GeoLite2 IP-range, and the GeoLite2 IP-range size is listed as 100%.

- "Same" indicates the percentage of country_codes in Database that are the same as the country_code in GeoLite2.
- "Diff" indicates the percentage of country_codes in Database that are different from GeoLite2 country_code.
- "Empty" shows the percentage of IPs with GeoLite2 country_code but no corresponding country_code in Database.
- "Extra" indicates the percentage of IPs with no GeoLite2 country_code listed that had a country_code listed in the Database.

## MMDB Libraries

If you would like to integrate MMDB files into an existing project there are several libraries that can help.

### Read MMDB files

Libraries exist in many languages when using the MMDB files. There are official, [Maxmind developed libraries](https://github.com/maxmind) for many popular languages: [.NET](https://github.com/maxmind/MaxMind-DB-Reader-dotnet), [C](https://github.com/maxmind/libmaxminddb), [Node.js](https://github.com/maxmind/GeoIP2-node), [Perl](https://github.com/maxmind/MaxMind-DB-Reader-perl), [PHP](https://github.com/maxmind/MaxMind-DB-Reader-php), [Python](https://github.com/maxmind/MaxMind-DB-Reader-python) and [Ruby](https://github.com/maxmind/MaxMind-DB-Reader-ruby), and third-party readers for others: [Erlang](https://github.com/g-andrade/locus), [Go](https://github.com/oschwald/maxminddb-golang), [Rust](https://github.com/oschwald/maxminddb-rust).

### Write MMDB files

If you wish to create your own MMDB files from the CSV files *(to customise their format)* there are a couple of official libraries: [Go](https://github.com/maxmind/mmdbwriter) and [Perl](https://github.com/maxmind/MaxMind-DB-Writer-perl) *(now archived)*. There are also some third-party options: [Python](https://github.com/VimT/MaxMind-DB-Writer-python) and [Rust](https://github.com/pierd/maxminddb-writer).

## Useful Libraries

| Library | Language | Description | Types | Auto<br>Updates |
|---|---|---|---|---|
|[ip-location-api](https://github.com/sapics/ip-location-api) | Node.js | Fast ip to country lookup by using in-memory database (7MB RAM) | `country`<br>`city` | ✓ |
|[country](https://github.com/sapics/ip-location-api/tree/main/browser/country)<br>[country-extra](https://github.com/sapics/ip-location-api/tree/main/browser/country-extra) | Browser js | Ip to country lookup in browser | `country` | ✓ |
|[geocode](https://github.com/sapics/ip-location-api/tree/main/browser/geocode)<br>[geocode-extra](https://github.com/sapics/ip-location-api/tree/main/browser/geocode-extra) | Browser js | Ip to geocode lookup in browser | `country`<br>`latitude`<br>`longitude` | ✓ |

## Useful applications

| Application | Language | Description | Types | Auto<br>Updates |
|---|---|---|---|---|
|[ip_location_server](https://github.com/EP-u-NW/ip_location_server) | Java | An in-memory GRPC and HTTP server mapping IP addresses to locations *(requires at least 1.5GB RAM)* | `country`<br>`asn`<br>`city` | ✓ |
|[ip-location-api](https://github.com/paul-norman/ip-location-api) | Go | API server creating / supporting MMDB, PostgreSQL, MySQL / MariaDB and SQLite | `country`<br>`asn`<br>`city` | ✓ |
|[Ip-geo-API](https://github.com/realchandan/Ip-geo-API) | Go | In-memory API server | `country` | ✘ |
|[IPInfoOffline](https://www.nirsoft.net/utils/ip_country_info_offline.html) | Windows  | Desktop tool showing information about IP addresses *(local data)* | `country`<br>`asn`<br>`city` | ✘ |

## Useful tools

| Tool | Description |
|---|---|
|[ip-location-to-mmdb](https://github.com/paul-norman/ip-location-to-mmdb) | Basic conversion from CSV files from this database into MMDB files |
|[mmdbmeld](https://github.com/safing/mmdbmeld) | Create and customise MMDB files from CSV files in this database |

## Licences

The required licence depends upon the database which you use. **Please carefully read each database licence before use.**

You can use [PDDL](https://opendatacommons.org/licenses/pddl/1.0/) (ODC Public Domain Dedication and Licence) licensed databases without attribution for any purpose.

## Support

We'd be grateful if you could link back to [sapics/ip-location-db](https://github.com/sapics/ip-location-db), and star this project to help others find it.