MaxMind GeoLite2

GeoIP lookups use MaxMind’s free GeoLite2 City database. Sign up at maxmind.com/en/geolite2/signup, generate a license key, then set:

MAXMINDDB_USER_ID=<your-account-id>
MAXMINDDB_LICENSE_KEY=<your-license-key>

On startup GeoMetrikks downloads the database and refreshes it every GEOIP_REFRESH_DAYS (default 7). You never handle .mmdb files yourself.

Both the GeoLite2 City and GeoLite2 ASN databases are downloaded: City powers the map and geo analytics, ASN adds the network and organization behind each request. Set GEOIP_ASN_ENABLED=false to skip the ASN database.

Using the database means accepting the MaxMind GeoLite2 EULA.

Map tiles

The map draws its basemap from CARTO, using OpenStreetMap data. CARTO’s terms require every deployment to send its own API key. Keys are free for up to five million tile requests a month; request one at carto.com/basemaps/apikey and set:

MAP_CARTO_API_KEY=<your-key>

The key is sent to the browser and appended to every basemap request, so treat it as public. Without a key the map still loads today, but CARTO may watermark or refuse keyless tiles at any time.

The map shows the CARTO and OpenStreetMap attribution in its corner. Keep it visible; both licenses require it.