kmtnflower/backend/geo/README.md

GeoLite2 City Database

The visitor stats dashboard uses MaxMind GeoLite2 for IP geolocation.

Setup

1. Create a free account at MaxMind GeoLite2
2. Download the GeoLite2 City database (.mmdb format, not CSV)
3. Place the downloaded file here as GeoLite2-City.mmdb

The file is git-ignored (~60 MB, licensed). The Docker build copies it into the container at /app/geo/GeoLite2-City.mmdb.

Without the database

The backend starts but geo lookups are disabled. The dashboard shows visitor counts without country/region breakdown.