Skip to content

Make GeoIP attribution customizable via provider config - #208

Open
bozaro wants to merge 1 commit into
mpolden:masterfrom
bozaro:customizable-geoip-attribution
Open

bozaro wants to merge 1 commit into
mpolden:masterfrom
bozaro:customizable-geoip-attribution

Conversation

@bozaro

@bozaro bozaro commented Oct 30, 2026 •

Copy link
Copy Markdown

The web UI previously hardcoded MaxMind GeoLite2 attribution for any geolocation database, which is incorrect (and a CC BY 4.0 license violation) for DB-IP Lite databases.

Attributions and detection rules now live in iputil/geo/providers.yaml, embedded into the binary and overridable at runtime:

  • Provider is auto-detected from MMDB metadata (database_type/description) using ordered glob rules, so DB-IP databases are credited with a link to db-ip.com automatically
    • geo-providers / ECHOIP_GEO_PROVIDERS points to a replacement YAML file (e.g. Docker mount), allowing new providers without code changes
    • geo-provider / ECHOIP_GEO_PROVIDER forces a provider id, 'none' hides the attribution block (commercial DB-IP requires no attribution)
  • Unknown databases render no attribution (fallback: none)
  • Multiple databases from different providers render deduplicated attributions

@bozaro
bozaro force-pushed the customizable-geoip-attribution branch from 0286d24 to 927e1c3 Compare October 30, 2026 05:51
The web UI previously hardcoded MaxMind GeoLite2 attribution for any
geolocation database, which is incorrect (and a CC BY 4.0 license
violation) for DB-IP Lite databases.

Attributions and detection rules now live in iputil/geo/providers.yaml,
embedded into the binary and overridable at runtime:

- Provider is auto-detected from MMDB metadata (database_type/description)
  using ordered glob rules, so DB-IP databases are credited with a link
  to db-ip.com automatically
  - geo-providers / ECHOIP_GEO_PROVIDERS points to a replacement YAML file
  (e.g. Docker mount), allowing new providers without code changes
  - geo-provider / ECHOIP_GEO_PROVIDER forces a provider id, 'none' hides
  the attribution block (commercial DB-IP requires no attribution)
- Unknown databases render no attribution (fallback: none)
- Multiple databases from different providers render deduplicated
  attributions
@bozaro
bozaro force-pushed the customizable-geoip-attribution branch from 927e1c3 to a4f336e Compare October 30, 2026 05:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant