---
title: 'application:geolocation'
url: 'https://docs.danami.com/warden/command-line-interface/application/application-geolocation'
markdown: 'https://docs.danami.com/warden/command-line-interface/application/application-geolocation.md'
date: '2026-10-07'
description: 'Configure the MaxMind geolocation database settings. warden --task=application:geolocation Option Value Default Description --license_key <string> The free license key that was generated from Maxmind. --db_update_interval <digit> 30 The geolocation database update interval (in days)…'
taxonomy:
  category:
    - docs
---

[](#)  [ Basics ](https://docs.danami.com/warden/)     [ Command Line Interface ](https://docs.danami.com/warden/command-line-interface)      Application       application:geolocation    

# application:geolocation

Configure the MaxMind geolocation database settings.

```
warden --task=application:geolocation
```

| Option | Value | Default | Description |
|---|---|---|---|
| `--license_key` | <string> |  | The free license key that was generated from Maxmind. |
| `--db_update_interval` | <digit> | 30 | The geolocation database update interval (in days). |
| `--internal_cache` | <1\|0> | 1 | Enable an internal cache for geolocation database lookups. |
| `--default` | <yes> |  | Reset all settings to their default values. |
| `--default_option` | <option> |  | Reset a specific setting to its default value. |
| `--download_city` | <yes> |  | Download the GeoIP2 city database. |
| `--download_asn` | <yes> |  | Download the GeoIP2 ASN database. |
| `--download_country` | <yes> |  | Download the GeoIP2 country database. |
| `--force` | <yes> |  | Force download of the GeoIP2 database even if it already exists. |

## Examples

```
// set the MaxMind license key
warden --task=application:geolocation --license_key=XXXXXXXXXXXXXXX

// force download the GeoIP2 city and GeoIP2 ASN databases even if they exist
warden --task=application:geolocation --download_city=yes --download_asn=yes --force=yes

// set the license key and immediately re-download the city and ASN databases
warden --task=application:geolocation --license_key=XXXXXXXXXXXXXXX --download_city=yes --download_asn=yes --force=yes
```

 [ ](https://docs.danami.com/warden/command-line-interface/application/application-dashboard) [](https://docs.danami.com/warden/command-line-interface/application/application-license)

---

## Navigation

- Previous: [application:dashboard](https://docs.danami.com/warden/command-line-interface/application/application-dashboard.md)
- Next: [application:license](https://docs.danami.com/warden/command-line-interface/application/application-license.md)