---
title: "GeoIP"
weight: 40
description: "Configuring GeoIP geolocation to identify the geographic origin of connections."
source_hash: "7368475f"
---

# GeoIP

SmartAuth can use the GeoIP database to geolocate connection IP addresses. This feature is optional.

## Installation

1. Go to **Home > Setup > Modules > SmartAuth**
2. Open the **GeoIP** tab
3. Click **Download and initialize GeoIP**

![GeoIP configuration page with the download button](screenshots/configuration-geoip.webp)

SmartAuth automatically downloads the GeoLite2-City database and configures the required Dolibarr constants:

- `GEOIP_VERSION` is set to 1
- `MAIN_MODULE_GEOIPMAXMIND` is enabled
- `GEOIPMAXMIND_COUNTRY_DATAFILE` points to the downloaded file

The file is stored in `DOL_DATA_ROOT/geoipmaxmind/GeoLite2-City.mmdb`.

## Verification

After the download, the page displays a confirmation message indicating that the file is installed and that the configuration is complete.

## Usage

Once GeoIP is enabled, connection IP addresses can be associated with a country and a city in the logs and the dashboard.
