Skip to main content

Try free on Pangolin Cloud

Fastest way to get started with Pangolin using the hosted control plane. No credit card required.
To enable geoblocking in Pangolin Community you must download and place the Maxmind geoip database into the config/ directory and update the config 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.
It is possible to automate this process with a Docker container from Maxmind themself. Have a look at this Community guide on how to implement this!
You can use the installer to download and place the database for you, just grab the latest installer: 
curl -fsSL https://static.pangolin.net/get-installer.sh | bash
Then run the installer again: 
./installer

​
Manual Installation Steps

1

Download and extract the GeoIP database

Download and extract the GeoLite2 Country database using the following commands:
# Download the GeoLite2 Country database
curl -L -o GeoLite2-Country.tar.gz https://github.com/GitSquared/node-geolite2-redist/raw/refs/heads/master/redist/GeoLite2-Country.tar.gz

# Extract the database
tar -xzf GeoLite2-Country.tar.gz

# Move the .mmdb file to the config directory
mv GeoLite2-Country_*/GeoLite2-Country.mmdb config/

# Clean up the downloaded files
rm -rf GeoLite2-Country.tar.gz GeoLite2-Country_*
2

Update the Pangolin config file

Update your Pangolin configuration to point to the new GeoIP database file. Edit your config/config.yml file to include the following entry:
server:
  maxmind_db_path: "./config/GeoLite2-Country.mmdb"
3

Restart Pangolin

Restart your Pangolin instance to apply the changes:
  docker compose restart pangolin
Alternatively, you can create an account at Maxmind to get a license key and download the database directly from them.