{"id":16576,"date":"2021-01-22T14:32:18","date_gmt":"2021-01-22T14:32:18","guid":{"rendered":"http:\/\/wiki2.plumserver.com\/?post_type=ht_kb&p=16576"},"modified":"2026-03-09T13:17:11","modified_gmt":"2026-03-09T17:17:11","slug":"magento-2-ip-geolocation-lookup-v1-x-databases-manual-installation","status":"publish","type":"post","link":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v1\/devguide\/databases-manual-installation","title":{"rendered":"Magento 2 IP Geolocation Lookup v1.x Databases Manual Installation"},"content":{"rendered":"\n

Manually Installing IP Geolocation Databases<\/h2>\n\n\n\n

Plumrocket IP Geolocation Lookup Magento 2 extension<\/a> supports two methods of IP Geolocation database installation: automatic and manual. In this guide, we will describe how to manually download and install IP Geolocation databases.\u00a0<\/p>\n\n\n\n

Maxmind IP Geolocation Database<\/h3>\n\n\n\n
Step 1. Download Maxmind IP Geolocation Database<\/h5>\n\n\n\n
\n

1. Create a directory on the server:<\/p>\n\n\n\n

[MAGENTO_PATH]<\/mark>\/pub\/media\/prgeoiplookup\/data\/<\/em><\/p>\n\n\n\n

2. For Maxmind, you need the following files:<\/p>\n\n\n\n

GeoLite2-City-Blocks-IPv4.csv
GeoLite2-City-Locations-en.csv<\/strong><\/span><\/p>\n\n\n\n

<\/p>\n<\/div><\/div>\n\n\n\n

To download the files, create a free account on maxmind.com<\/a>, and follow the steps below:<\/p>\n\n\n\n

\n

Step-by-step guide:<\/p>\n\n\n\n

  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<\/strong> button.
    In the sidebar menu, go to the GeoIP2 \/ GeoLite2 > Download Files<\/strong>.<\/li>
  2. In the same grid, find the GeoLite2 City: CSV Format<\/strong> row, and click on the Download ZIP<\/strong> 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<\/strong><\/span><\/p><\/li><\/ol>\n<\/div><\/div>\n\n\n\n

    \"\"<\/figure>\n\n\n\n
    \n

    Step-by-step guide:<\/p>\n\n\n\n

    3. Paste the files into the following paths:<\/p>\n\n\n\n

    [MAGENTO_PATH]<\/mark>\/pub\/media\/prgeoiplookup\/data\/<\/em>GeoLite2-City-Blocks-IPv4.csv<\/span><\/strong>
    [MAGENTO_PATH]<\/mark>\/pub\/media\/prgeoiplookup\/data\/<\/em>GeoLite2-City-Locations-en.csv<\/span><\/strong><\/p>\n<\/div><\/div>\n\n\n\n

    Step 2. Install Maxmind IP Geolocation Database<\/h5>\n\n\n\n

    To install Maxmind manually, go to the extension’s Configuration <\/strong>> Services <\/strong>> Maxmind IP Geolocation Database<\/strong> > Installation Method<\/strong>, and select Manual Installation<\/em>.<\/p>\n\n\n\n

    \"magento<\/figure>\n\n\n\n

    After selecting the Installation Method, click Install Database<\/strong>. In a few minutes, depending on the server capacity, the database will be installed.<\/p>\n\n\n\n

    IpToCountry IP Geolocation Database<\/h3>\n\n\n\n
    Step 1. Download IpToCountry IP Geolocation Database<\/h5>\n\n\n\n
    \n

    1. Create a directory on the server:<\/p>\n\n\n\n

    [MAGENTO_PATH]<\/mark>\/pub\/media\/prgeoiplookup\/data\/<\/em><\/em><\/p>\n\n\n\n

    2. For IpToCountry, you need the IpToCountry.csv<\/span><\/strong> file, which you can get there:<\/p>\n\n\n\n