Magento 2 GeoIP Lookup v1.x Databases Manual Installation

Manually Installing GeoIP Databases

Plumrocket GeoIP Lookup Magento 2 extension supports two methods of GeoIP database installation: automatic and manual. In this guide, we will describe how to manually download and install GeoIP databases. 

Maxmind GeoIP Database

Step 1. Download Maxmind GeoIP Database

1. Create a directory on the server:

[MAGENTO_PATH]/pub/media/prgeoiplookup/data/

2. For Maxmind, you need the following files:

GeoLite2-City-Blocks-IPv4.csv
GeoLite2-City-Locations-en.csv

To download the files, create a free account on maxmind.com, and follow the steps below:

Step-by-step guide:

  1. Log in to the Maxmind account, then click on the account icon on the upper left side of the page, and press the My Account button.
    In the sidebar menu, go to the GeoIP2 / GeoLite2 > Download Files.
  2. In the same grid, find the GeoLite2 City: CSV Format row, and click on the Download ZIP link there. You will download the ZIP file and get the files needed for Maxmind database installation:

    GeoLite2-City-Blocks-IPv4.csv
    GeoLite2-City-Locations-en.csv

Step-by-step guide:

3. Paste the files into the following paths:

[MAGENTO_PATH]/pub/media/prgeoiplookup/data/GeoLite2-City-Blocks-IPv4.csv
[MAGENTO_PATH]/pub/media/prgeoiplookup/data/GeoLite2-City-Locations-en.csv

Step 2. Install Maxmind GeoIP Database

To install Maxmind manually, go to the extension’s Configuration > Services > Maxmind GeoIP Database > Installation Method, and select Manual Installation.

magento 2 geoip lookup extension databases manual installation

After selecting the Installation Method, click Install Database. In a few minutes, depending on the server capacity, the database will be installed.

IpToCountry GeoIP Database

Step 1. Download IpToCountry GeoIP Database

1. Create a directory on the server:

[MAGENTO_PATH]/pub/media/prgeoiplookup/data/

2. For IpToCountry, you need the IpToCountry.csv file, which you can get there:

  • Website:
  • Wget command: wget software77.net/geo-ip/?DL=2 -O /path/IpToCountry.csv.zip

3. Paste the file into the following path:

[MAGENTO_PATH]/pub/media/prgeoiplookup/data/IpToCountry.csv

Step 2. Install IpToCountry GeoIP Database

To install IpToCountry manually, go to the extension’s Configuration in the Magento backend (Plumrocket tab > GeoIP Lookup extension > Services > IpToCountry GeoIP Database > Installation Method), and select Manual Installation.

<figure class="wp-block-image size-full size-large">

After selecting the Installation Method, click Install Database. In a few minutes, depending on the server capacity, the database will be installed.

Was this article helpful?