Deploy cloudflared replicas

To deploy multiple instances of cloudflared, you can create and configure one tunnel and run it on multiple hosts. If your tunnel runs as a service, only one cloudflared instance is allowed per host.

You can run the same tunnel across various cloudflared processes for up to 100 connections (25 replicas) per tunnel. Cloudflare Load Balancers and DNS records can still point to the tunnel and its UUID. Traffic will be sent to all cloudflared processes associated with the tunnel.

Deploy replicas in Kubernetes

For information about running cloudflared in a Kubernetes deployment, refer to the Kubernetes guide.

Remotely-managed tunnels

1. To create a remotely-managed tunnel, follow the dashboard setup guide.
2. On the Tunnels page, select your newly created tunnel.
3. In the side panel, scroll down to Connectors to view the cloudflared instances for that tunnel.
4. Select Edit.
5. Select the operating system of the host where you want to deploy a replica.
6. Copy the installation command and run it on the host.

The new replica will appear on the Connectors list for the tunnel. All replicas will serve the same routes and use the same configuration parameters.

Locally-managed tunnels

1. To create a locally-managed tunnel, complete Steps 1 through 5 in the CLI setup guide.

2. Run your newly created tunnel.

   cloudflared tunnel run <NAME>

   This will start a cloudflared instance and generate a unique connector_id.

3. In a separate window or on another host, run the same command again:

   cloudflared tunnel run <NAME>

   This will initialize another cloudflared instance and generate another connector_id.

4. Run tunnel info to show each cloudflared instance running your tunnel:

   cloudflared tunnel info <NAME>

This will output your tunnel UUID as well as two Connector IDs, one for each cloudflared process running your tunnel. With this command, you can also see that your tunnel is now being served by eight connections.