> For the complete documentation index, see [llms.txt](https://ciusji.gitbook.io/luden/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ciusji.gitbook.io/luden/features/geo-data-resolution.md).

# Geo Data Resolution

Luden looks up geolocation data by IP address during enrichment step. Here's a full list of fields Luden could get from the IP address:

```
{
  "location": {
    "continent": "North America",
    "country": "US",
    "country_name": "United States",
    "region": "NY",
    "city": "New York",
    "latitude": 40.7809,
    "longitude": -73.9502,
    "zip": "10128",
    "autonomous_system_number": 16509,
    "autonomous_system_organization": "AMAZON-02",
    "organization": "Amazon.com",
    "domain": "amazonaws.com"
  }
}
```

## Configuration <a href="#configuration" id="configuration"></a>

**Luden** uses [MaxMind](https://www.maxmind.com/) databases for doing geo lookup. There are two families of MaxMind databases: `GeoIP2` and `GeoLite2`.

`GeoIP2` databases such as `GeoIP2-Country`, `GeoIP2-City`, `GeoIP2-ISP`, `GeoIP2-Domain` are paid product. You can buy a license on [maxmind.com](https://www.maxmind.com/en/geoip2-databases). After purchasing, you will receive a license key. You can use the license key Luden:

* Put obtained license key on Luden UI → Geo data resolver section if you're using Configurator UI.
* Or use [`MAX_MIND_PATH` env variable](https://jitsu.com/docs/other-features/geo-data-resolution#configuration).

**`GeoLite2`** databases such as `GeoLite2-Country`, `GeoLite2-City`, `GeoLite2-ASN` are free. For obtaining them you should just create a [free account](https://dev.maxmind.com/geoip/geolite2-free-geolocation-data) and generate a license key. Configuration steps are the same as with paid database: either put obtained license key on Jitsu UI → Geo data resolver, or use`MAX_MIND_PATH`

With the key, Luden will download all databases available for the key. If you want to limit the databases, you can specify them as a postfix to Maxmind license key as `[key]?edition_id=GeoIP2-City,GeoIP2-ISP`

Also, you can point MAX\_MIND\_PATH environment variable directly to a local file.