{"id":27546,"date":"2024-08-14T09:50:29","date_gmt":"2024-08-14T13:50:29","guid":{"rendered":"https:\/\/plumrocket.com\/docs\/?p=27546"},"modified":"2026-03-13T04:38:01","modified_gmt":"2026-03-13T08:38:01","slug":"magento-2-ip-geolocation-lookup-v2-x-databases-manual-installation","status":"publish","type":"post","link":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/devguide\/databases-manual-installation","title":{"rendered":"Magento 2 IP Geolocation Lookup v2.x Databases Manual Installation"},"content":{"rendered":"\n<h2 id=\"h-manually-installing-geoip-databases\">Manually Installing GeoIP Databases<\/h2>\n\n\n\n<p>Plumrocket <a href=\"\/magento-geoip-lookup\">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.&nbsp;<\/p>\n\n\n\n<h3 id=\"h-maxmind-ip-geolocation-database\">Maxmind IP Geolocation Database<\/h3>\n\n\n\n<h5 id=\"h-step-1-download-maxmind-ip-geolocation-database\">Step 1. Download Maxmind IP Geolocation Database<\/h5>\n\n\n\n<div class=\"wp-block-group pr-notice pr-notice-info\"><div class=\"wp-block-group__inner-container\">\n<p>1. Create a directory on the server if it does not exist:<\/p>\n\n\n\n<p><em><mark>[MAGENTO_PATH]<\/mark>\/pub\/media\/prgeoiplookup\/data\/<\/em><\/p>\n\n\n\n<p><\/p>\n<\/div><\/div>\n\n\n\n<p>Create a free account on <a href=\"http:\/\/maxmind.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">maxmind.com<\/a>, and follow the steps below:<\/p>\n\n\n\n<div class=\"wp-block-group pr-notice pr-notice-info\"><div class=\"wp-block-group__inner-container\">\n<p class=\"pr-notice-title\">Step-by-step guide:<\/p>\n\n\n\n<ol><li>Log in to the Maxmind account on <a href=\"http:\/\/maxmind.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">maxmind.com<\/a>, then click on the account icon on the upper left side of the page, and press the <strong>My Account<\/strong> button. <br>In the sidebar menu, go to the <strong>GeoIP2 \/ GeoLite2 &gt; Download Files<\/strong>.<\/li><li>In the same grid, find the <strong>GeoLite2 City<\/strong> row, and click on the <strong>Download ZIP<\/strong> link there. You will download the ZIP file and get the file needed for Maxmind database installation:<br><p><span style=\"color:#cc371d\" class=\"has-inline-color\"><strong>GeoLite2-City.mmdb<br><\/strong><\/span><\/p><\/li><\/ol>\n<\/div><\/div>\n\n\n\n<figure class=\"wp-block-image size-full size-large\"><img loading=\"lazy\" width=\"1206\" height=\"761\" src=\"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2024\/08\/GeoIP_Lookup_database_installation_1.png\" alt=\"GeoIP_Lookup_database_installation_1\" class=\"wp-image-27548\" srcset=\"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2024\/08\/GeoIP_Lookup_database_installation_1.png 1206w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2024\/08\/GeoIP_Lookup_database_installation_1-300x189.png 300w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2024\/08\/GeoIP_Lookup_database_installation_1-1024x646.png 1024w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2024\/08\/GeoIP_Lookup_database_installation_1-768x485.png 768w\" sizes=\"(max-width: 1206px) 100vw, 1206px\" \/><\/figure>\n\n\n\n<div class=\"wp-block-group pr-notice pr-notice-info\"><div class=\"wp-block-group__inner-container\">\n<p class=\"pr-notice-title\">Step-by-step guide:<\/p>\n\n\n\n<ol><li>Rename the downloaded file to <strong>MaxMind.mmdb<\/strong><\/li><li>Paste the file into the following paths: <em><mark>[MAGENTO_PATH]<\/mark>\/pub\/media\/prgeoiplookup\/data\/<\/em><strong>MaxMind.mmdb<\/strong><\/li><li>Go to <strong>Plumrocket &gt; IP Geolocation Lookup &gt; Configuration &gt; Maxmind IP Geolocation Database<\/strong> and validate the installation (Database Status field must be green and show Installed Database status)<\/li><\/ol>\n<\/div><\/div>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" width=\"1203\" height=\"461\" src=\"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-1.png\" alt=\"GeoIP_Lookup_database_installation_2\" class=\"wp-image-29008\" srcset=\"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-1.png 1203w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-1-300x115.png 300w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-1-1024x392.png 1024w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-1-768x294.png 768w\" sizes=\"(max-width: 1203px) 100vw, 1203px\" \/><\/figure>\n\n\n\n<h5 id=\"h-step-2-install-maxmind-ip-geolocation-database\">Step 2. Install Maxmind IP Geolocation Database<\/h5>\n\n\n\n<p>To install Maxmind manually, go to the extension&#8217;s <strong>Configuration <\/strong>&gt; <strong>Services <\/strong>&gt; <strong>Maxmind IP Geolocation Database<\/strong> &gt; <strong>Installation Method<\/strong>, and select <em>Manual Installation<\/em>.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" width=\"1204\" height=\"674\" src=\"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-2.png\" alt=\"GeoIP_Lookup_database_installation_3\" class=\"wp-image-29010\" srcset=\"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-2.png 1204w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-2-300x168.png 300w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-2-1024x573.png 1024w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-2-768x430.png 768w\" sizes=\"(max-width: 1204px) 100vw, 1204px\" \/><\/figure>\n\n\n\n<p>After selecting the Installation Method, click <strong>Install Database<\/strong>. In a few minutes, depending on the server capacity, the database will be installed.<\/p>\n\n\n\n<h3 id=\"h-iptocountry-ip-geolocation-database\">IpToCountry IP Geolocation Database<\/h3>\n\n\n\n<h5 id=\"h-step-1-download-iptocountry-ip-geolocation-database\">Step 1. Download IpToCountry IP Geolocation Database<\/h5>\n\n\n\n<div class=\"wp-block-group pr-notice pr-notice-info\"><div class=\"wp-block-group__inner-container\">\n<p>1. Create a directory on the server if it does not exist:<\/p>\n\n\n\n<p><em><mark>[MAGENTO_PATH]<\/mark>\/pub\/media\/<em>prgeoiplookup\/data\/<\/em><\/em><\/p>\n\n\n\n<p>2. Go to <a href=\"https:\/\/db-ip.com\/db\/download\/ip-to-country-lite\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/db-ip.com\/db\/download\/ip-to-country-lite<\/a><\/p>\n\n\n\n<p>3. Scroll down and press the <strong>Download IP to Country Lite<\/strong> MMDB button. You will download the GZ archive and get the file needed for Maxmind database installation: <strong>dbip-country-lite-{build-date}.mmdb<\/strong><\/p>\n<\/div><\/div>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" width=\"1206\" height=\"768\" src=\"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2024\/08\/GeoIP_Lookup_database_installation_3.png\" alt=\"GeoIP_Lookup_database_installation_3\" class=\"wp-image-27552\" srcset=\"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2024\/08\/GeoIP_Lookup_database_installation_3.png 1206w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2024\/08\/GeoIP_Lookup_database_installation_3-300x191.png 300w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2024\/08\/GeoIP_Lookup_database_installation_3-1024x652.png 1024w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2024\/08\/GeoIP_Lookup_database_installation_3-768x489.png 768w\" sizes=\"(max-width: 1206px) 100vw, 1206px\" \/><\/figure>\n\n\n\n<div class=\"wp-block-group pr-notice pr-notice-info\"><div class=\"wp-block-group__inner-container\">\n<p class=\"pr-notice-title\">Step-by-step guide:<\/p>\n\n\n\n<ol><li>Rename the downloaded file to <strong><span style=\"color:#cc371d\" class=\"has-inline-color\">IpToCountry.mmdb<\/span><\/strong><\/li><li>Paste the file into the following path: <em><em><mark>[MAGENTO_PATH]<\/mark><\/em>\/pub\/media\/prgeoiplookup\/data\/<span style=\"color:#cc371d\" class=\"has-inline-color\">IpToCountry.mmdb<\/span><\/em><\/li><li>Go to <strong>Plumrocket &gt; IP Geolocation Lookup &gt; Configuration &gt; IpToCountry IP Geolocation Database<\/strong> and validate the installation (Database Status field must be green and show Installed Database status)<\/li><\/ol>\n<\/div><\/div>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" width=\"1203\" height=\"515\" src=\"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-3.png\" alt=\"GeoIP_Lookup_database_installation_4\" class=\"wp-image-29011\" srcset=\"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-3.png 1203w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-3-300x128.png 300w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-3-1024x438.png 1024w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-3-768x329.png 768w\" sizes=\"(max-width: 1203px) 100vw, 1203px\" \/><\/figure>\n\n\n\n<h5 id=\"h-step-2-install-iptocountry-ip-geolocation-database\">Step 2. Install IpToCountry IP Geolocation Database<\/h5>\n\n\n\n<p>To install IpToCountry manually, go to the extension&#8217;s Configuration in the Magento backend (<strong>Plumrocket tab<\/strong> &gt; <strong>IP Geolocation Lookup extension<\/strong> &gt; <strong>Services <\/strong>&gt; <strong>IpToCountry IP Geolocation Database<\/strong> &gt; <strong>Installation Method<\/strong>), and select <em>Manual Installation<\/em>.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" width=\"1206\" height=\"698\" src=\"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-4.png\" alt=\"GeoIP_Lookup_database_installation_5\" class=\"wp-image-29012\" srcset=\"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-4.png 1206w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-4-300x174.png 300w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-4-1024x593.png 1024w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-dev-guide1-4-768x444.png 768w\" sizes=\"(max-width: 1206px) 100vw, 1206px\" \/><\/figure>\n\n\n\n<p>After selecting the Installation Method, click <strong>Install Database<\/strong>. In a few minutes, depending on the server capacity, the database will be installed.<\/p>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Manually Installing GeoIP Databases Plumrocket IP Geolocation Lookup Magento 2 extension 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.&nbsp; Maxmind IP Geolocation Database Step 1. Download Maxmind IP Geolocation Database Create a free account on maxmind.com, and &hellip; <\/p>\n<p class=\"link-more\"><a href=\"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/devguide\/databases-manual-installation\" class=\"more-link\">Continue reading<span class=\"screen-reader-text\"> &#8220;Magento 2 IP Geolocation Lookup v2.x Databases Manual Installation&#8221;<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"_mi_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0},"categories":[2],"tags":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v17.2 (Yoast SEO v17.2) - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Magento 2 IP Geolocation Lookup v2.x Databases Manual Installation - Plumrocket Documentation<\/title>\n<meta name=\"description\" content=\"Manually Installing GeoIP Databases Plumrocket IP Geolocation Lookup Magento 2 extension supports two methods of IP Geolocation database installation:\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/devguide\/databases-manual-installation\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Magento 2 IP Geolocation Lookup v2.x Databases Manual Installation\" \/>\n<meta property=\"og:description\" content=\"Manually Installing GeoIP Databases Plumrocket IP Geolocation Lookup Magento 2 extension supports two methods of IP Geolocation database installation:\" \/>\n<meta property=\"og:url\" content=\"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/devguide\/databases-manual-installation\" \/>\n<meta property=\"og:site_name\" content=\"Plumrocket Documentation\" \/>\n<meta property=\"article:published_time\" content=\"2024-08-14T13:50:29+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-03-13T08:38:01+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2024\/08\/GeoIP_Lookup_database_installation_1.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Plumrocket\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Magento 2 IP Geolocation Lookup v2.x Databases Manual Installation - Plumrocket Documentation","description":"Manually Installing GeoIP Databases Plumrocket IP Geolocation Lookup Magento 2 extension supports two methods of IP Geolocation database installation:","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/devguide\/databases-manual-installation","og_locale":"en_US","og_type":"article","og_title":"Magento 2 IP Geolocation Lookup v2.x Databases Manual Installation","og_description":"Manually Installing GeoIP Databases Plumrocket IP Geolocation Lookup Magento 2 extension supports two methods of IP Geolocation database installation:","og_url":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/devguide\/databases-manual-installation","og_site_name":"Plumrocket Documentation","article_published_time":"2024-08-14T13:50:29+00:00","article_modified_time":"2026-03-13T08:38:01+00:00","og_image":[{"url":"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2024\/08\/GeoIP_Lookup_database_installation_1.png"}],"twitter_card":"summary_large_image","twitter_misc":{"Written by":"Plumrocket","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebSite","@id":"https:\/\/plumrocket.com\/docs\/#website","url":"https:\/\/plumrocket.com\/docs\/","name":"Plumrocket Documentation","description":"Extensions docs, troubleshootings etc.","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/plumrocket.com\/docs\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"ImageObject","@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/devguide\/databases-manual-installation#primaryimage","inLanguage":"en-US","url":"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2024\/08\/GeoIP_Lookup_database_installation_1.png","contentUrl":"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2024\/08\/GeoIP_Lookup_database_installation_1.png","width":1206,"height":761},{"@type":"WebPage","@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/devguide\/databases-manual-installation#webpage","url":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/devguide\/databases-manual-installation","name":"Magento 2 IP Geolocation Lookup v2.x Databases Manual Installation - Plumrocket Documentation","isPartOf":{"@id":"https:\/\/plumrocket.com\/docs\/#website"},"primaryImageOfPage":{"@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/devguide\/databases-manual-installation#primaryimage"},"datePublished":"2024-08-14T13:50:29+00:00","dateModified":"2026-03-13T08:38:01+00:00","author":{"@id":"https:\/\/plumrocket.com\/docs\/#\/schema\/person\/c96fccdb89342ae6804272265723eca8"},"description":"Manually Installing GeoIP Databases Plumrocket IP Geolocation Lookup Magento 2 extension supports two methods of IP Geolocation database installation:","breadcrumb":{"@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/devguide\/databases-manual-installation#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/devguide\/databases-manual-installation"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/devguide\/databases-manual-installation#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Docs","item":"https:\/\/plumrocket.com\/docs"},{"@type":"ListItem","position":2,"name":"Magento 2 Extensions","item":"https:\/\/plumrocket.com\/docs\/magento-extensions"},{"@type":"ListItem","position":3,"name":"Magento 2 IP Geolocation Lookup v2.x Databases Manual Installation"}]},{"@type":"Person","@id":"https:\/\/plumrocket.com\/docs\/#\/schema\/person\/c96fccdb89342ae6804272265723eca8","name":"Plumrocket","image":{"@type":"ImageObject","@id":"https:\/\/plumrocket.com\/docs\/#personlogo","inLanguage":"en-US","url":"https:\/\/secure.gravatar.com\/avatar\/10c44aa45aab391250913d982e552e53?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/10c44aa45aab391250913d982e552e53?s=96&d=mm&r=g","caption":"Plumrocket"}}]}},"_links":{"self":[{"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/posts\/27546"}],"collection":[{"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/comments?post=27546"}],"version-history":[{"count":5,"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/posts\/27546\/revisions"}],"predecessor-version":[{"id":29013,"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/posts\/27546\/revisions\/29013"}],"wp:attachment":[{"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/media?parent=27546"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/categories?post=27546"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/tags?post=27546"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}