This repository automatically builds IP geolocation databases in the .mmdb database format for both IPv4 and IPv6.
Building is handled via the mmdbmeld golang package and the database sources originate from ip-location-db.
These databases are automatically updated daily at 1:00 AM UTC. That may or may not match the schedule for the upstream sources and as such it is possible these databases may be slightly out of date.
Effort has gone into making these workflows efficient for all parties involved. If you see an inefficiency or issue in the automation process, feel free to report it.
Some basic automated testing is performed to help identify which database best suits a given use case. These are still being improved and worked on, but you can find the documentation on them here
This repository is configured to automatically delete releases older than 7 days. For this reason, you should always use the appropriate link which points to the latest release. In the event that something breaks and new releases aren't automatically being published, the latest release will always be preserved regardless of it's age.
These URLs will always point to the latest version of the database.
| License | Database Type | IPv4 | IPv6 | IPv4 & IPv6 |
|---|---|---|---|---|
| CC0 License | Country | cc0-v4-country.mmdb | cc0-v6-country.mmdb | cc0-both-country.mmdb |
| PDDL License | ASN | pddl-asn-v4.mmdb | pddl-asn-v6.mmdb | pddl-asn-both.mmdb |
| PDDL License | Country | pddl-country-v4.mmdb | pddl-country-v6.mmdb | pddl-country-both.mmdb |
| PDDL License | Country + ASN | pddl-country-asn-v4.mmdb | pddl-country-asn-v6.mmdb | pddl-country-asn-both.mmdb |
| CC0 License + PDDL License | Country (CC0) + ASN (PDDL) | cc0-pddl-country-asn-v4-variant-1.mmdb | cc0-pddl-country-asn-v6-variant-1.mmdb | cc0-pddl-country-asn-both-variant-1.mmdb |
Countrydatabases include what country an IP address is associated with.ASNdatabases include ASN information for a given IP address.
All code in this repository is licensed under the CC0 license. The mmdbmeld and ip-location-db projects each have their own licenses as do the original databases. Presently, we only build databases utilizing data that's under the CC0 and PDDL licenses which should be noted both in their file name as well as the variants section of this document.