Skip to main content

How to enable IP identification in Chatwoot?

Chatwoot lets you identify the user's location by geocoding the IP address. For IP Address geocoding, we support MaxmindDB services. This lookup provides methods for geocoding IP addresses without calling a remote API every time. You can follow the steps below to set up your self-hosted instance with the geocoding.

Step 1: Create an account at MaxmindDB and create an API key.

Step 2: Add the following environment variables.


With this step, Chatwoot would automatically download the MaxmindDB downloadable databases and cache it locally.

Step 3: Enable IP Lookup on your account. You can do this in two ways.

  • Method 1 via Superadmin console UI

    Log into the super admin and select accounts. Select your account, click edit, and toggle the ip_lookup feature.

  • Method 2 via Rails console

RAILS_ENV=production bundle exec rails console
account_id = 1 // Please fill your account id instead of 1
account = Account.find(account_id)