mirror of
https://github.com/wp-statistics/GeoLite2-City.git
synced 2025-12-29 14:12:24 +00:00
f58c55a434f071ab92ddc5606033a4b6508b3d3e
GeoLite2-City - Free IP Geolocation Database
Free MaxMind GeoLite2-City database for IP geolocation. Get city-level location data from any IP address. Automatically updated and served via jsDelivr CDN.
Website: geo.wp-statistics.com
Last updated: 2025-12-21
Features
- City-Level Accuracy - Get country, city, coordinates, timezone, and more
- Auto-Updated - Database updated automatically every Tuesday & Friday
- Fast CDN - Served via jsDelivr with global edge locations
- No Authentication - Direct download, no API keys required
- Free Forever - Open source under CC BY-SA 4.0 license
Quick Start
Direct Download
https://cdn.jsdelivr.net/npm/geolite2-city/GeoLite2-City.mmdb.gz
PHP
use GeoIp2\Database\Reader;
$reader = new Reader('/path/to/GeoLite2-City.mmdb');
$record = $reader->city('128.101.101.101');
echo $record->country->name; // 'United States'
echo $record->city->name; // 'Minneapolis'
Node.js
const { Reader } = require('@maxmind/geoip2-node');
const reader = await Reader.open('./GeoLite2-City.mmdb');
const response = reader.city('128.101.101.101');
console.log(response.country.names.en); // 'United States'
console.log(response.city.names.en); // 'Minneapolis'
Python
import geoip2.database
reader = geoip2.database.Reader('./GeoLite2-City.mmdb')
response = reader.city('128.101.101.101')
print(response.country.name) # 'United States'
print(response.city.name) # 'Minneapolis'
WordPress (WP Statistics)
use WP_Statistics\Service\Geolocation\GeolocationFactory;
$location = GeolocationFactory::getLocation('128.101.101.101');
echo $location['city']; // 'Minneapolis'
Database Info
| Property | Value |
|---|---|
| CDN URL | https://cdn.jsdelivr.net/npm/geolite2-city/GeoLite2-City.mmdb.gz |
| npm | npm install geolite2-city |
| Update Schedule | Every Tuesday & Friday (automatic) |
| Size | ~68 MB (compressed) |
| Format | MaxMind DB (MMDB) |
| License | CC BY-SA 4.0 |
Update Schedule
This database is automatically updated via GitHub Actions:
- Schedule: Every Tuesday and Friday at 06:00 UTC
- Source: MaxMind GeoLite2
- Distribution: Published to npm, served via jsDelivr CDN
Related Resources
- Documentation: geo.wp-statistics.com
- DB-IP Alternative: DbIP-City-lite
- Country Database: GeoLite2-Country
- WP Statistics: wordpress.org/plugins/wp-statistics
Attribution
This database is provided by MaxMind. When using this database, please include appropriate attribution as required by the CC BY-SA 4.0 license.
License
GeoLite2-City by MaxMind is licensed under CC BY-SA 4.0.
Maintained by VeronaLabs and the WP Statistics team.