Frequently Asked Questions

What is whoami.run?

A tiny service that shows your public IP, reverse DNS and common request headers via browser or curl.

Do you use Cloudflare?

Yes — traffic is proxied through Cloudflare (CDN/DDoS protection).

Do you store logs?

No request logs are stored during normal operation. The server has a debug mode for local development that prints request metadata to stderr; this is disabled in production.

Do you set cookies or use analytics?

No. There are no cookies, no third-party analytics, and no trackers.

What personal data is returned?

Only what your client already sends: IP address, reverse DNS, and request headers.

How do I install and uninstall the CLI?

Install with:

curl -fsSL https://whoami.run/install | bash

Uninstall with:

whoami-ip uninstall

How do I rename the CLI?

Run whoami-ip rename <new-name> or reinstall with ?cmd=<new-name>.

How can I pass custom curl options?

Set WHOAMI_RUN_CURL_OPTS before invoking the CLI. The flags you provide are appended to each internal curl call, which is useful for proxies, timeouts, or custom headers.

export WHOAMI_RUN_CURL_OPTS='--proxy http://proxy.example:3128'

Unset the variable to revert to the defaults. All native curl environment options (for example HTTPS_PROXY, CURL_CA_BUNDLE, or settings from ~/.curlrc) continue to be respected.

How do I disable ANSI colors?

Use --no-color, set WHOAMI_RUN_NO_COLOR=1, or rely on the standard NO_COLOR variable.

Why does IPv6 fail?

Your connection may not have IPv6 connectivity. The ipv6 endpoint returns an error in that case; /ip will return IPv4 instead.

Is geolocation precise?

Only the country code is reported, typically via the CF-IPCountry header. No city or GPS data is used.

Which endpoints should I use in scripts?

Use /ip, /ipv4, /ipv6 for addresses and /json for everything at once. For single, dedicated endpoints are available.