MaxMind GeoIP

Automatic GeoLite2 database updates for geographic IP enrichment.

Automatic Updates

When MAXMIND_ACCOUNT_ID and MAXMIND_LICENSE_KEY are configured, GeoLite2 databases update automatically on Wednesday and Saturday at 7:00 AM (local time per TZ).

The receiver hot-reloads databases via signal - no container restart needed. Updated databases are picked up immediately by the enrichment pipeline.

Manual Update

To trigger a GeoIP database update manually:

$
docker exec unifi-log-insight /app/geoip-update.sh

Check Update Logs

To view the GeoIP update log and verify that databases are downloading correctly:

$
docker exec unifi-log-insight cat /var/log/geoip-update.log