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

DNS record

Before you start
1. Add a website to Cloudflare
2. Change your domain nameservers to Cloudflare
3. Enable Argo Smart Routing for your account
4. Install cloudflared and authenticate the software
5. Create an Argo Tunnel

Route traffic from the Cloudflare dashboard

When you create an Argo Tunnel, Cloudflare generates a subdomain of with the UUID of the created Tunnel. You can treat that subdomain as if it were an origin target in the Cloudflare dashboard.

Unlike publicly routable IP addresses, the subdomain will only proxy traffic for a DNS record in the same Cloudflare account. If someone discovers your subdomain UUID, they will not be able to create a DNS record in another account or system to proxy traffic to the address.

  1. Navigate to the Cloudflare DNS tab.
  2. Create a new CNAME record and input the subdomain of your Tunnel into the Target field.
  3. Click Save.

DNS tab

The DNS record is distinct from the state of the Tunnel. You can create DNS records that point to a Tunnel that is not currently running. If the Tunnel stops running, the DNS record will not be deleted. If you point the DNS record to a Tunnel not currently running visitors will see a 1016 error message.

Additionally, you can create multiple DNS records that point to the same Tunnel subdomain.

Route traffic from the command line

You can create DNS records from cloudflared, which will provision a CNAME record that points to the subdomain of a specific Tunnel. The result is the same as creation from the dashboard above.

To do so, run the following command.

cloudflared tunnel route dns <UUID or NAME>

The command will create a CNAME record that points to the Tunnel subdomain, but will not proxy traffic if the Tunnel is not currently running.

Note: this command requires the cert.pem file.