Automatically downloads the latest MaxMind GeoLite2 databases every 3 days and publishes them as GitHub Releases.
- ⏰ Scheduled Updates — Runs every 3 days at 1:00 AM (UTC+8) via GitHub Actions
- 🔘 Manual Trigger — Can also be triggered manually from the Actions tab
- 📦 Auto Release — Creates a date-tagged GitHub Release with all database files
- 🧹 Auto Cleanup — Retains only the latest 3 releases to save storage
- 🔧 Configurable — Edition IDs are managed in a simple config file
| Edition ID | Format | Description |
|---|---|---|
| GeoLite2-ASN | .tar.gz |
ASN database (binary) |
| GeoLite2-ASN-CSV | .zip |
ASN database (CSV) |
| GeoLite2-City | .tar.gz |
City-level geolocation (binary) |
| GeoLite2-City-CSV | .zip |
City-level geolocation (CSV) |
| GeoLite2-Country | .tar.gz |
Country-level geolocation (binary) |
| GeoLite2-Country-CSV | .zip |
Country-level geolocation (CSV) |
To add or remove databases, edit edition_ids.txt.
-
Fork this repository.
-
Go to your repo's Settings → Secrets and variables → Actions and add the following secrets:
Secret Description MAXMIND_ACCOUNT_IDYour MaxMind account ID MAXMIND_LICENSE_KEYYour MaxMind license key You can obtain these from your MaxMind account portal.
-
The workflow will run automatically on schedule. You can also trigger it manually from the Actions tab.
Go to the Releases page to download the latest GeoLite2 database files.
Each release is tagged with the date (e.g., 2026-03-21) and contains all configured database files named by their Edition ID (e.g., GeoLite2-City.tar.gz).
This project is licensed under the MIT License.
Note: The GeoLite2 databases are provided by MaxMind under their own End User License Agreement. Please review and comply with their terms when using the downloaded databases.