Maxmind File

The Maxmind File GeoIP provider allows you to use Maxmind’s GeoIP databases stored in local files to perform geolocation lookups. This provider is useful when you want to avoid external API calls and have the GeoIP data available locally.

To use this provider, set spi-geoaware-geoip--provider to maxmind-file and configure the following options:

Name Description
spi-geoaware-geoip–maxmind-file–db-path The directory in which GeoAware looks for the database file. Defaults to data/geoaware.
spi-geoaware-geoip–maxmind-file–db-name Optional. The name of the database file. If not set, GeoAware uses the first .mmdb file found in the configured directory.

Make sure to download the appropriate Maxmind GeoIP database file (e.g., GeoLite2-City.mmdb) and place it in the specified directory. The file needs to be in the Maxmind DB format (MMDB). You can obtain the database files from the Maxmind website. Please note that Maxmind databases are updated regularly, so ensure you have a process in place to keep your local database files up to date.

Review Maxmind’s licensing terms to ensure compliance when using their GeoIP databases.


This site uses Just the Docs, a documentation theme for Jekyll.