Skip to main content
Pangolin uses a GeoIP database to map request IP addresses to approximate locations. That location data powers multiple features, including country and region access rules, geo-blocking patterns, and analytics. To enable geo-location features in Pangolin self-hosted, download a MaxMind GeoIP database, place it in the config/ directory, and point Pangolin at the database file. This can be done for free.
Remember to keep the GeoIP database updated regularly, as IP-to-country mappings can change over time. You can just repeat the download and extraction steps periodically to ensure your database is current.
You can automate this process with a MaxMind Docker container. See the GeoLite2 Automation community guide for an example.

​
Install with the Installer

You can use the installer to download and place the database for you. Download the latest installer:
Then run the installer again:

​
Manual Installation

1

Download and extract the GeoIP database

Download and extract the GeoLite2 Country database using the following commands:
2

Update the Pangolin config file

Update your Pangolin configuration to point to the new GeoIP database file. Edit config/config.yml to include the following entry:
3

Restart Pangolin

Restart your Pangolin instance to apply the changes:
Alternatively, you can create an account at MaxMind to get a license key and download the database directly from them.
After the geo-location database is enabled, use access control rules or the Geo-blocking guide to create blocking or allow rules.