Skip to content

Linux

You can install cloudflared as a system service on Linux.

Prerequisites

Before you install Cloudflare Tunnel as a service on Linux, follow Steps 1 through 4 of the Tunnel CLI setup guide. At this point you should have a named tunnel and a config.yml file in your .cloudflared directory.

1. Configure cloudflared as a service

By default, Cloudflare Tunnel expects all of the configuration to exist in the $HOME/.cloudflared/config.yml configuration file. At a minimum you must specify the following arguments to run as a service:

ArgumentDescription
tunnelThe UUID of your tunnel
credentials-fileThe location of the credentials file for your Tunnel

2. Run cloudflared as a service

  1. Install the cloudflared service.

    Terminal window
    $ cloudflared service install
  2. Start the service.

    Terminal window
    $ systemctl start cloudflared
  3. (Optional) View the status of the service.

    Terminal window
    $ systemctl status cloudflared

Next steps

You can now route traffic through your tunnel. If you add IP routes or otherwise change the configuration, restart the service to load the new configuration:

Terminal window
$ systemctl restart cloudflared