whoami.runconnection details

Command-line Client (CLI)

Install

Install the lightweight CLI to query endpoints quickly:

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

Default command name is whoami-ip. You can choose another name via ?cmd=<name>.

Usage

whoami-ip [command] [--no-color]

Commands

  • (no arg): Show formatted connection details
  • ip: Show public IP (v4 or v6)
  • ipv4 | v4: Show IPv4
  • ipv6 | v6: Show IPv6
  • json: Show all details in JSON
  • hostname: Show reverse DNS hostname
  • country: Show detected country (CF header)

Options

  • --no-color: Disable ANSI colors for the default view
  • WHOAMI_RUN_NO_COLOR=1: Disable ANSI colors via environment (also honors NO_COLOR)

Maintenance

  • rename <new-name>: Install the CLI under a new name
  • update: Update CLI to the latest version
  • version | -v: Show client/server version status
  • uninstall: Remove the installed CLI from PATH

Examples

whoami-ip
whoami-ip ip
whoami-ip ipv6
whoami-ip json
whoami-ip rename GetMyPubIP

Uninstall

Remove the installed CLI command. Use the name you installed (default is whoami-ip):

whoami-ip uninstall
  • Removes the CLI file if it resides under your home directory.
  • If installed outside your home, you'll be asked to remove it manually.
  • Restart your shell if the command still appears available.
  • Note: PATH entries added to ~/.bashrc or ~/.zshrc are not removed automatically.

Installed path by default: ~/.local/bin/<name>. If you chose a custom name, run <name> uninstall.