The GeoIP databases are sold by MaxMind. MaxMind sells different databases, each with different amounts and types of information.

The country and city databases can be used to determine the location of an IP address with different amounts granularity:

  • The country database can only tell you the country of an IP address.
  • And, the city database can tell you the country, region, city, postal code, geographic coordinates (latitude/longitude) and area code of an IP address.

The ISP and Organization database can be used to determine the ISP and company of an IP address.

You can find more information on the commercial GeoIP2 databases here.

MaxMind also provides two free databases that are less accurate than the commercial ones. One of the free databases can only be used to determine an IP address’ country. The other, called GeoLite2 City, can be used to determine the same information as the commercial city database. Additionally there is a free GeoLite2 ASN database, which can be used as ISP database.

You can find more information on the free GeoLite2 databases here.

Needless to say, we recommend using one of the city databases.

Matomo includes a tool that will download the GeoLite2 City database for you. You can access the tool by navigating to Settings > Geolocation.

If you want to install the database by hand, you can download each of the free databases here. Make sure to download the binary versions of the databases.

Keep in mind that geolocation data will eventually become out of date. It is recommended you update your databases at least once a month.* The free databases are updated once a month on the first Tuesday.

Note: The latest version of Matomo includes an auto-updater for the GeoIP2 databases.

If you are installing the databases manually, then once you get the database you want to use copy it to Matomo’s path/to/matomo/misc/ subdirectory.