dev.maxmind.com Open in urlscan Pro
199.36.158.100  Public Scan

Form analysis
1 forms found in the DOM

/search-results

<form action="/search-results" class="SearchBar-module--searchbar--ac1a1" role="search"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 512 512" class="fa-icon SearchBar-module--mag--e90b4" height="1em" width="1em"
    xmlns="http://www.w3.org/2000/svg">
    <path
      d="M505 442.7L405.3 343c-4.5-4.5-10.6-7-17-7H372c27.6-35.3 44-79.7 44-128C416 93.1 322.9 0 208 0S0 93.1 0 208s93.1 208 208 208c48.3 0 92.7-16.4 128-44v16.3c0 6.4 2.5 12.5 7 17l99.7 99.7c9.4 9.4 24.6 9.4 33.9 0l28.3-28.3c9.4-9.4 9.4-24.6.1-34zM208 336c-70.7 0-128-57.2-128-128 0-70.7 57.2-128 128-128 70.7 0 128 57.2 128 128 0 70.7-57.2 128-128 128z">
    </path>
  </svg><input aria-label="Search" class="SearchBar-module--input--a1ebd" id="search" name="q" placeholder="Search" type="search" value=""><input aria-label="Submit" class="SearchBar-module--hidden--463c5" type="submit"></form>

Text Content

 * Skip to content
 * Skip to navigation
 * Skip to search
 * Skip to footer

Developers

 * 
   minFraud
   * Evaluate a Transaction
   * Report a Transaction
   * Track Devices
   * minFraud Alerts
   * Working with Transaction Dispositions
   * API Documentation
   * Release Notes
   * Sandbox Environment
   * Contribute
   * minFraud Legacy
   * Proxy Detection Legacy Web Service
   * MaxMind Server IP Addresses
   * Knowledge Base
 * 
   GeoIP2 and GeoLite2
   * Geolocate an IP
     * Databases
     * Web Services
     * Client-side JavaScript
   * Updating Databases
   * Importing Databases
     * Import to PostgreSQL
     * Import to MySQL
   * GeoLite2 Free Geolocation Data
   * Privacy Exclusions API
   * Web Services Documentation
   * Database Documentation
   * Release Notes
   * Contribute
   * MaxMind Server IP Addresses
   * License Key Validation API
   * Knowledge Base
   * MMDB Format Spec


UPDATING GEOIP AND GEOLITE DATABASES

On this Page
 * Using GeoIP Update
   * Install GeoIP Update
   * Obtain GeoIP.conf with Account Information
   * Run GeoIP Update
   * Troubleshooting
 * Directly downloading databases
   * Checking for the Latest Release Date
 * Changes to file size between updates
 * Download limits

In January 2024, we began using R2 presigned URLs for all database downloads.
You should make sure that your HTTP client follows redirects and there are no
proxy or firewall settings that would block requests to the host we are
redirecting to. We will redirect requests using HTTPS on the following hostname:

 * mm-prod-geoip-databases.a2649acb697e2c09b632799562c076f2.r2.cloudflarestorage.com

Existing database download links will continue to work, they will simply be
redirected.

Read our release note for more information.

There are two methods for automatically updating GeoIP2 and GeoLite binary
databases:

 1. Using MaxMind's GeoIP Update program.
 2. Directly downloading the database.

For clients using our binary database format, we highly recommend using GeoIP
Update, but the direct download method is available if necessary. Clients using
the CSV-format databases must use the direct download method.


USING GEOIP UPDATE

MaxMind provides the GeoIP Update program, which performs automatic updates for
both GeoIP2 and GeoLite2 binary databases.

MaxMind uses R2 presigned URLs for database downloads. Make sure that your
servers can make HTTPS connections to the following hostname:

 * mm-prod-geoip-databases.a2649acb697e2c09b632799562c076f2.r2.cloudflarestorage.com


1. INSTALL GEOIP UPDATE

Install GeoIP Update. The latest release may be downloaded from GitHub Releases.
See the installation instructions for more information. GeoIP Update can also be
installed via our Docker image.

If you are using an older version of GeoIP Update, you may need to upgrade to
GeoIP Update 4.x or later version. The 4.x and later versions meet our
requirement for using TLS 1.2 or greater for all requests to our servers to keep
your data secure.

Please see our upgrade guide for more information on upgrading from an older
version of GeoIP Update.


2. OBTAIN GEOIP.CONF WITH ACCOUNT INFORMATION

Log in to your account portal to download a partially pre-filled configuration
file and save it in your configuration directory (e.g., /usr/local/etc/) as
GeoIP.conf. You will need to replace the YOUR_LICENSE_KEY_HERE placeholder with
an active license key associated with your MaxMind account. You can see your
license key information on your account License Keys page.

You may also write this file by hand using the template below (not recommended).

Note that for geoipupdate versions less than 2.5.0, use UserId instead of
AccountID and ProductIds instead of EditionIDs.

# GeoIP.conf file - used by geoipupdate program to update databases
# from http://www.maxmind.com
AccountID YOUR_ACCOUNT_ID_HERE
LicenseKey YOUR_LICENSE_KEY_HERE
EditionIDs YOUR_EDITION_IDS_HERE


3. RUN GEOIP UPDATE

Run geoipupdate. To fully automate this process on Linux or Unix, use a crontab
file like:

# top of crontab
MAILTO=your@email.com

53 5 * * 0,4 /usr/local/bin/geoipupdate
# end of crontab

This crontab file would run twice a week, and it would email you the results.

If you are running a firewall, geoipupdate requires that the DNS and HTTPS (443)
ports be open.


TROUBLESHOOTING

If you receive an error when running GeoIP Update, you can use the verbose
option by adding the -v flag. This will print out each step taken as it runs.
The information provided can often help to clarify issues. Additional
instructions for GeoIP Update can be viewed when running man geoipupdate on the
command line.

Please note that GeoIP Update requires current access to database updates to run
properly. If your subscription needs to be renewed, updates can be purchased
while logged into your Account Summary page.

Updating to the latest release of GeoIP Update may be required to resolve some
errors. If you are not currently using version 4 or higher of GeoIP Update and
would like to learn about upgrading to the current version of the program, read
our guide on how to upgrade to GeoIP Update version 4.x.

Starting in 2024, MaxMind began using R2 presigned URLs for database downloads.
If your server is refusing the connection during download, make sure that your
servers can make HTTPS connections to the following hostname:

 * mm-prod-geoip-databases.a2649acb697e2c09b632799562c076f2.r2.cloudflarestorage.com


DIRECTLY DOWNLOADING DATABASES

This is only recommended for systems unable to use GeoIP Update or for clients
using the CSV-format databases.

In order to download the databases from a script or program, please use the
permalinks found on the GeoIP download page. Please note that you will be
redirected from these permalinks because MaxMind uses R2 presigned URLs for
database downloads. You should make sure that your HTTP client follows redirects
and there are no proxy or firewall settings that would block requests to the
host we are redirecting to. We will redirect requests using HTTPS on the
following hostname:

 * mm-prod-geoip-databases.a2649acb697e2c09b632799562c076f2.r2.cloudflarestorage.com

To directly download databases, follow these steps:

 1. In the “Download Links” column, click “Get Permalink(s)” for the desired
    database.
 2. Copy the permalink(s) provided in the modal window.
 3. Provide your account ID and your license key using Basic Authentication to
    authenticate.
 4. If you are using wget or curl from a shell script, please be sure to quote
    the URL.

This download will return a compressed file in gzip (for binary) or zip (for
CSV) format, which can be uncompressed using a program like 7-Zip or gzip.

For example, using the permalink for the GeoIP2 City CSV database, you can issue
a curl command like the following:

curl -O -J -L -u YOUR_ACCOUNT_ID:YOUR_LICENSE_KEY 'https://download.maxmind.com/geoip/databases/GeoIP2-City-CSV/download?suffix=zip'

Or a wget command like the following:

wget --content-disposition --user=YOUR_ACCOUNT_ID --password=YOUR_LICENSE_KEY 'https://download.maxmind.com/geoip/databases/GeoIP2-City-CSV/download?suffix=zip'

Where YOUR_ACCOUNT_ID is a placeholder for your account ID and YOUR_LICENSE_KEY
is a placeholder for your license key. Learn more about license keys on our
knowledge base.

These examples will save the database to a file called
GeoIP2-City-CSV_YYYYMMDD.zip where YYYYMMDD is the date of the latest release.

We also maintain example zip files on the corresponding GeoIP database
documentation pages (see the GeoIP City example file), and tutorials for
importing CSV databases into SQL.


CHECKING FOR THE LATEST RELEASE DATE

You can check the date of a given database’s latest release by issuing a HEAD
request for that database’s download permalink URL. The download permalink can
be found in the Download Databases section of your account portal.

For example, using the permalink for the GeoIP2 City CSV database, you can issue
a curl command like the following:

curl -I -L -u YOUR_ACCOUNT_ID:YOUR_LICENSE_KEY 'https://download.maxmind.com/geoip/databases/GeoIP2-City-CSV/download?suffix=zip'

Or a wget command like the following:

wget -S --method HEAD --user=YOUR_ACCOUNT_ID --password=YOUR_LICENSE_KEY 'https://download.maxmind.com/geoip/databases/GeoIP2-City-CSV/download?suffix=zip'

Where YOUR_ACCOUNT_ID is a placeholder for your account ID and YOUR_LICENSE_KEY
is a placeholder for your license key. Learn more about license keys on our
knowledge base.

In the response, you can check the last-modified header for the file’s build
date, or you can check the content-disposition header for the date that would
appear in the file name. These checks can be incorporated into your own script
or program, according to your needs.

This method only issues a HEAD request, rather than a download request, so
running this check won’t count against your daily database download limit.


CHANGES TO FILE SIZE BETWEEN UPDATES

It is expected for database files to increase or decrease in size from time to
time between releases. As we incorporate data corrections and new data sources,
we will add entries to our databases. Sometimes IP ranges are taken out of use
and removed. You should develop your integration with the expectation that
changes to the size of our databases will occur.

When we anticipate significant changes to the size of our databases, we will
notify customers by posting a release note.


DOWNLOAD LIMITS

MaxMind reserves the right to limit the number of downloads made within a
limited period of time.

This page was last updated on September 12, 2024.

PreviousClient-side JavaScriptNextImporting Databases


PRODUCTS

minFraud ServicesGeoIP2 Anonymous IP DatabaseGeoIP2 Enterprise DatabaseGeoIP2
web servicesGeoIP2 DatabasesGeoLite2 Free Geolocation DataAffiliate Program


SUPPORT

Knowledge BaseminFraudGeoIP System StatusGeoIP Data Correction RequestYour
Privacy ChoicesNotice of Collection


DEVELOPERS

Developer PortalminFraudGeoIPAffiliate Program


COMPANY

About MaxMindWorking at MaxMindCommitment to SecurityCharitable GivingContact Us

© 2024 MaxMind, Inc. MaxMind, GeoIP, minFraud, and related trademarks belong to
MaxMind, Inc.

Terms of UsePrivacy Policy