Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

tuna --list

List all Cloudflare tunnels for your account.

Usage

tuna --list

Output

$ tuna --list
 
🔐 Touch ID required
 
TUNNELS for example.com (4)
 
NAME                           STATUS    DOMAIN                     CREATED
tuna-alice-api-example-com     ● active  alice-api.example.com      2024-01-23 10:49
tuna-bob-api-example-com       ● active  bob-api.example.com        2024-01-23 11:15
tuna-staging-example-com       ● active  staging.example.com        2024-01-22 15:30
tuna-old-project-example-com   ○ down    old-project.example.com    2024-01-20 08:15
 
● = active   ○ = down

Status Indicators

SymbolStatusMeaning
●activeTunnel has active connections
○downTunnel exists but no connections

What It Shows

  • NAME - Tunnel identifier (auto-generated by tuna)
  • STATUS - Whether the tunnel is currently connected
  • DOMAIN - DNS record pointing to the tunnel
  • CREATED - When the tunnel was created

Multiple Domains

If you have credentials for multiple domains, you'll be prompted:

$ tuna --list
 
Select domain:
  1. example.com (4 tunnels)
  2. another-domain.com (2 tunnels)
> All domains

Filtering by Project

The list shows all tuna-created tunnels. Tuna tunnels are named with the pattern:

tuna-{sanitized-forward-domain}

Use Cases

See Team Activity

Check which team members have active tunnels:

$ tuna --list

Tunnels with $USER in the config show each developer's username.

Find Old Tunnels

Identify tunnels that are no longer needed:

$ tuna --list
# Look for "down" status or old creation dates

Verify Tunnel Status

Check if your tunnel is running:

$ tuna --list
# Find your tunnel and check status

Related Commands

See Also