Migrate to Named Tunnels with Load Balancer
If you are using Legacy Tunnel today you can migrate to Named Tunnel deployment in less than 10 minutes.
🗺️ This tutorial covers how to:
- Migrate a Legacy Tunnel deployment to Named Tunnel model
- Use Cloudflare Load Balancer to perform a zero downtime migration
⏲️ Time to complete:
Creating a Legacy Tunnel with Cloudflare Load Balancer
This tutorial starts by documenting the steps to create a Legacy Tunnel with Cloudflare Load Balancer so that those can be compared to the migration steps. If you would prefer to start the migration now, please .
In both modes, the first step is to create a Load Balancer and Origin Pool. Navigate to the
Traffic tab of the Cloudflare dashboard. Input a public-facing DNS hostname for a domain in your Cloudflare account.
Next, create an origin pool for the load balancer. This will be a group of origins, whether Cloudflare Tunnel connections or traditional IP addresses, used by the load balancer.
In Legacy mode, adding a new instance of
cloudflared into a Load Balancer pool must be done from the command line tool itself. The
cloudflared agent will start and create 4 separate connections, enrolling each of these into a load balancer pool.
$ cloudflared tunnel --hostname app.widgetcorp.tech --url http://localhost:8000 --lb-pool lisbon-data-center
However, the Legacy Tunnel mode has some downsides, including:
- You cannot manage these connections from the Cloudflare dashboard.
cloudflaredrestarts, it will attempt to register these connections as new connections which can lead to service disruption.
The Named Tunnel, documented below, model provides easier management and greater stability.
Create a Named Tunnel
To begin, create a Named Tunnel with the following command.
$ cloudflared tunnel create lisbon-app
This command will create a Tunnel object in your Cloudflare account that is represented by this instance of
cloudflared. You can point DNS records or LB records to this connection when you run the Tunnel.
Create a configuration file
Next, configure your Tunnel. The example below consists of a web service that is available at port 8000. The ingress rule will send traffic that
cloudflared receives for the specified hostname to that port. You can also connect with a single instance of
In the configuration file, you must specify the location of the credentials file generated previously when you created the Tunnel.
You can save the configuration file.
Run the Tunnel
You can now run the Tunnel. Running the Tunnel will connect
cloudflared to Cloudflare’s edge in a connection only available to your account. You can use the Tunnel ID value to treat that connection like the IP address of an origin, without the risk of someone reaching it directly and bypassing Cloudflare.
Run the following command, replacing
lisbon-app with the name of your Tunnel.
$ cloudflared tunnel run lisbon-app
Migrate the Load Balancer configuration
You can now begin migrating your Load Balancer deployment to use the new Named Tunnel. Create a new Origin Pool in the Load Balancer. Add a new origin to the list.
In the origin address field, input the ID of the tunnel followed by
cfargotunnel.com. In this example, the origin address value would be
Wait 1 minute while the new origin is recognized as healthy by Cloudflare Load Balancer. Once healthy, you can begin to disable the Legacy Argo Tunnel origins from the legacy Load Balancer pool.