Skip to content
Argo Tunnel
Visit Argo Tunnel on GitHub
Set theme to dark (⇧+D)

Create a Tunnel

Before you start
1. Add a website to Cloudflare
2. Change your domain nameservers to Cloudflare
3. Install cloudflared and authenticate the software
4. Understand the overview for using Argo Tunnels

Create a Tunnel

Run the following command to create a Tunnel.

$ cloudflared tunnel create <NAME>

Replace <NAME> with the name you want to give to the Tunnel. The name assigned can be any string and does not need to relate to the hostname where traffic will be served.

This command will create a Tunnel with the name provided and associate it with a UUID. The relationship between the UUID and the name is persistent. The command will not create a connection at this point.

Create a tunnel

Creating a Tunnel generates a credentials file for that specific Tunnel. This file is distinct from the cert.pem file. To run the Tunnel without managing DNS from cloudflared, you only need the credentials file.

Actioncert.pemCredentials file
Create a new TunnelRequired-
Delete a TunnelRequired-
Run a TunnelAvailableRequired
Create DNS records
from cloudflared
Required-
Connect to load balancer
pools from cloudflared
Required-
Route traffic to a running Tunnel
from the Cloudflare dashboard
AvailableAvailable

List available Tunnels

cloudflared can list all created Tunnels in your account, as well as those actively connected to Cloudflare, by running the following command:

cloudflared tunnel list

Note: the command requires the cert.pem file.

List tunnels

Revoke and delete a Tunnel

You can delete an existing Tunnel with cloudflared. To delete a Tunnel, run the following command:

$ cloudflared tunnel delete <NAME>

Note: the command requires the cert.pem file.

If there are still active connections on that tunnel, then you will have to force the deletion with:

$ cloudflared tunnel delete -f <NAME>

This will cause those connections to be dropped.

Deleting the tunnel also invalidates the credentials file associated with that Tunnel, meaning those connections can not be re-established again.