geoip

Manage GeoLite2 MMDB assets and inspect GeoIP lookup configuration.

xrat geoip <command> [flags]

Subcommands

Command	Description
`download`	Download one or more GeoLite2 MMDB editions
`update`	Refresh all supported GeoLite2 MMDB editions
`path`	Print the resolved MMDB directory
`status`	Show MMDB presence and size for each supported edition
`lookup`	Look up a single IP through the configured GeoIP backend
`backend`	Print the active GeoIP backend configuration

Download one or more GeoLite2 MMDB editions.

xrat geoip download [flags]

Flag	Description
`--edition <name>`	Edition to download. Repeatable: `GeoLite2-Country`, `GeoLite2-City`, `GeoLite2-ASN` or `country`, `city`, `asn`
`--all`	Download all supported editions
`--output <dir>`	Override the MMDB target directory for this command
`--force`	Re-download even when the destination file already exists
`--url <url>`	Override the download URL template. Use `{edition}` as a placeholder
`--timeout <secs>`	Override the HTTP request timeout in seconds
`--quiet`	Suppress progress bar output

If neither --edition nor --all is given, the configured default_editions from [mmdb] are used.

Download all editions to the default MMDB directory:

xrat geoip download --all

Download a single edition:

xrat geoip download --edition city

Download to a custom directory:

xrat geoip download --all --output ./testdata/xrat/mmdb

Refresh all supported GeoLite2 MMDB editions. Equivalent to download --all --force.

xrat geoip update [flags]

Flag	Description
`--output <dir>`	Override the MMDB target directory for this command
`--url <url>`	Override the download URL template. Use `{edition}` as a placeholder
`--timeout <secs>`	Override the HTTP request timeout in seconds
`--quiet`	Suppress progress bar output

xrat geoip update

Print the resolved MMDB directory.

xrat geoip path [flags]

Flag	Description
`--output <dir>`	Override the MMDB target directory for this command

Resolution order:

--output flag, if provided
[mmdb].dir from config (resolved relative to XRAT_PATH or config file location)
Default: ~/.config/xrat/mmdb

xrat geoip path
xrat geoip path --output /custom/path

Show MMDB presence and size for each supported edition.

xrat geoip status [flags]

Flag	Description
`--output <dir>`	Override the MMDB target directory for this command
`--strict`	Exit non-zero when any supported edition is missing

xrat geoip status --strict

Look up a single IP address through the configured GeoIP backend.

xrat geoip lookup <ip> [flags]

Argument	Description
`ip`	IP address to look up

Flag	Description
`--backend <name>`	Override backend: `mmdb`, `ipwhois`, `ip-api`
`--no-cache`	Bypass the configured in-memory cache for this invocation
`--json`	Print the lookup result as JSON

The lookup returns country code, city/region, and ASN information when available.

xrat geoip lookup 8.8.8.8
xrat geoip lookup 8.8.8.8 --backend ipwhois
xrat geoip lookup 2001:4860:4860::8888 --json

Print the active GeoIP backend configuration.

xrat geoip backend [flags]

Flag	Description
`--backend <name>`	Override backend: `mmdb`, `ipwhois`, `ip-api`
`--no-cache`	Describe the backend chain without cache wrapping

Shows the backend type, configured fallback, rate limiting, and cache settings.

xrat geoip backend

If geoip status --strict reports missing files, download the supported MMDB editions:

xrat geoip download --all

If MMDB lookup fails but remote lookup works, check the resolved directory:

xrat geoip path
xrat geoip lookup 8.8.8.8 --backend ipwhois

Remote backends can be rate-limited by the provider. Use the default cache unless you specifically need --no-cache for diagnostics.