GeoLite2-City - Free IP Geolocation Database

npm version npm downloads License GitHub Stars

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-26


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


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.

Description
No description provided
Readme 600 MiB