GeoIP Intelligence

Janus uses self-hosted MaxMind GeoLite2 databases for GeoIP-based risk signals. All lookups happen in-memory — no data leaves your server.

GDPR-safe by design

Only the 2-letter country code is stored in the verification record. The full IP-to-location mapping is never persisted. Country codes are not personal data under GDPR.

Setup

1. Create a free MaxMind account at maxmind.com
2. Download GeoLite2-City and GeoLite2-ASN databases (.mmdb format)
3. Place them in data/geoip/ or set GEOIP_DB_PATH

mkdir -p data/geoip
cp GeoLite2-City.mmdb data/geoip/
cp GeoLite2-ASN.mmdb data/geoip/

GeoIP is fully optional. If databases are missing, Janus starts normally with geo signals disabled.

Risk signals

Blocked countries

Configure per site via the dashboard or API:

curl -X PUT https://your-janus.com/api/v1/sites/:id \
  -H 'Content-Type: application/json' \
  -d '{"settings": {"blockedCountries": ["XX", "YY"]}}'