NEXTJS & DOCKER & MAXMIND GEOLOCATION 🌍

This is a template to build our NextJs project on a Docker container and have IP geolocation through Maxmind integration.

DOCUMENTATIONS 📄

• Next.j s documentation
• Maxmind documentation
• Maxmind GeoIP Update repository
• Docker image Node.js
• mmdb-lib package
• Supercronic package

SETTINGS 🔧

First, we will access the project from the terminal and create the folder where we will store our .mmdb file:

cd nextjs-docker-maxmind
mkdir /maxmind/db

Attached to the repository we find a file .env.example We must clone this file and rename it to .env. Here we will find the environment variable that will indicate the path from which we will read our mmdb file, which will be the folder we just created.

We will need a GeoLite account on Maxmind. From which we will generate our license key.

Once we have our GeoLite account in Maxmind, we will have to manually download our mmdb file to be able to develop locally. We will place it in the folder we just created /maxmind/db which should be the same value we have in our environment variable MAXMIND_DB_PATH

Example:

MAXMIND_DB_PATH=maxmind/db/{{your_filename}}.mmdb
# REPLACE TO
MAXMIND_DB_PATH=maxmind/db/GeoLite2-city.mmdb

In the GeoIP.conf file located inside the /maxmind folder we will need to indicate our ACCOUNT ID and LICENSE KEY.

In the GeoIP.conf file we also find the DatabaseDirectory parameter which corresponds to the place where we want geoipupdate to download and update our maxmind databases. The directory indicated in this file must match the directory indicated in our MAXMIND_DB_PATH environment variable, since this is where our application will try to access the .mmdb file both in our local environment and in the Docker container.

By default the indicated directory will be /maxmind/db/.

Stated properties:

AccountID YOUR_ACCOUNT_ID_HERE
LicenseKey YOUR_LICENSE_KEY_HERE

DatabaseDirectory /app/maxmind/db

DEVELOPMENT 💻

To set up the project in development mode locally, we only need to manually download the Maxmind binary database (mmdb) that we want to use and place it in the /maxmind/db/ directory.

With Maxmind free tier, we have two options available:

• GeoLite2 Country
• GeoLite2 City

cd nextjs-docker-maxmind
mkdir /maxmind/db
# Copy our `.mmdb` file into this newly created folder,

npm install
npm run dev

A demo endpoint is built in at the /api/maxmind path.