Skip to content

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:

Terminal window
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

Section titled “Map”

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:

Terminal window
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.

Live routes fly to the location of the server that recorded them (see Multi-source setup); with a single server that is the app server’s own location, discovered at startup through ipify and looked up in the local GeoLite2 database. MAP_SERVER_LATITUDE and MAP_SERVER_LONGITUDE override that default location, MAP_SERVER_LOCATIONS overrides per server, and MAP_AUTO_DETECT_SERVER_LOCATION=false disables the outbound lookup. The old MAP_HOME_* and MAP_AUTO_DETECT_HOME names still work until 1.0. The map’s Route effects control can also hide the animation; that preference is kept in browser storage.

The map opens on the server locations, or on the whole world when there are none. Set MAP_DEFAULT_VIEW=latitude,longitude[,zoom] to open it somewhere else, for example MAP_DEFAULT_VIEW=71.129982,27.653369,15 for northern Norway at zoom 15.