The `cloudflared tunnel list` command is used to display a list of all Cloudflare Tunnels (formerly Argo Tunnels) associated with your Cloudflare account. This command provides an overview of your tunnels, including their ID, name, associated ingress rules, and status.
cloudflared tunnel list [flags]This command queries the Cloudflare API to retrieve information about the tunnels configured under your Cloudflare account. It's essential for managing your tunnels, as it allows you to quickly see which tunnels exist, their unique identifiers, and whether they are currently running.
The output typically includes columns like:
* **ID**: The unique identifier (UUID) for the tunnel.
* **NAME**: The user-defined name for the tunnel.
* **CREATED**: The timestamp when the tunnel was created.
* **CONNECTIONS**: The number of active `cloudflared` instances connected to the tunnel.
* **STATUS**: Indicates whether the tunnel is active or inactive.
* **CONFIGURED_BY**: The method or service that configured the tunnel (e.g., CLI, dashboard).
This command does not require any additional arguments, but it can be modified with flags to filter or format the output.
**1. List all Cloudflare Tunnels:**
To view a comprehensive list of all tunnels associated with your account, simply run the command without any flags:
cloudflared tunnel list**Expected Output Example:**
ID NAME CREATED CONNECTIONS STATUS CONFIGURED_BY
789abcdef0-1234-5678-9abc-def012345678 my-website-tunnel 2023-10-27T10:00:00Z GMT+0000 1 ACTIVE CLI
fedcba98-7654-3210-fedc-ba9876543210 internal-app 2023-10-25T14:30:00Z GMT+0000 0 INACTIVE CLI**2. Listing Tunnels in JSON Format (using --json flag):**
For scripting or programmatic use, you can output the tunnel list in JSON format. This is often useful for parsing the output with other tools.
cloudflared tunnel list --json**Expected Output Example (abbreviated):**
[
{
"id": "789abcdef0-1234-5678-9abc-def012345678",
"name": "my-website-tunnel",
"created_at": "2023-10-27T10:00:00Z",
"deleted_at": null,
"is_deleted": false,
"metadata": null,
"connections": [
{
"id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"version": "2023.10.0",
"arch": "amd64",
"os": "linux",
"private_ip": "192.168.1.100",
"opened_at": "2023-10-27T10:05:00Z",
"origin_ip": "203.0.113.1",
"origin_src_ip": "10.0.0.5"
}
],
"status": "ACTIVE",
"configured_by": "CLI"
}
]**3. Listing Tunnels with a Specific Name (using --name flag):**
If you want to view details for a tunnel with a specific name, you can use the `--name` flag.
cloudflared tunnel list --name my-website-tunnelThis will filter the output to show only tunnels matching the specified name. If multiple tunnels have the same name (though unique IDs), all will be listed. If no tunnel matches, an empty list will be returned.
* `--json`: Output the list in JSON format.
* `--name <tunnel-name>`: Filter tunnels by their name.
* `--help`: Display help information for the `tunnel list` command.
Always ensure you are authenticated with Cloudflare (e.g., by running `cloudflared tunnel login`) before attempting to list tunnels.