DEPRECATION NOTICE: Snowplow will stop hosting the Maxmind GeoLite2 database on behalf of users

(!) Snowplow Insights customers
This notice does not apply to our paid customers. We will continue to host the MaxMind database for you in the short-term to ensure you experience no service disruption. We will be in touch directly when you need to take action.

Snowplow users can leverage the IP Lookup Enrichment to enrich Snowplow data based on data stored in the different Maxmind databases, including the free GeoLite2 database.

Until now, we have hosted that database for Snowplow users on That means that anyone running Snowplow can enable the enrichment by configuring their config file as follows:

	"schema": "iglu:com.snowplowanalytics.snowplow/ip_lookups/jsonschema/2-0-0",

	"data": {

		"name": "ip_lookups",
		"vendor": "com.snowplowanalytics.snowplow",
		"enabled": true,
		"parameters": {
			"geo": {
				"database": "GeoLite2-City.mmdb",
				"uri": ""

Following new CCPA regulation in California, Maxmind has updated the basis on which this database is made available. It is now necessary that anyone who wants to use the database registers with Maxmind. (Maxmind is still kindly making the database freely available to registered users.) You can read more about the rationale for those changes on the Maxmind blog.

This means that we must no longer host the database on behalf of our users. We intend to remove the hosted asset by February 14th. As a result, we ask all users of the database to, as a matter of priority:

  1. Follow the steps to setup an account, license key and download the database detailed on the Maxmind blog post.
  2. Upload the database to S3 or GCS, but keep it private
  3. Update their Snowplow enrichment config file to point to the private asset

Doing this swiftly will prevent any disruption to your Snowplow pipeline once we stop hosting the asset.