GeoIP Lookups

GeoIP Lookups #

Owncast can display high-level geographic information about your current viewers if you enable GeoIP support in your instance.

We support the MaxMind GeoLite2 Database, and as long as you provide a free copy of the database it will be used. Perform the following in order to add this feature.

  1. Create a free account with MaxMind.
  2. Wait for an email and follow the link to your account.
  3. Under Database Products and Subscriptions click Download Databases.
  4. Download GeoLite2 City (GeoIP2 Binary .mmdb).
  5. Unzip the file and place the GeoLite2-City.mmdb file into the data directory of your Owncast server. Create this directory if needed.
Geo i p was first supported in Owncast 0.0.3.

Disclaimer #

If enabled this product includes GeoLite2 data created by MaxMind, available from