Cloudflare Docs
Cloudflare Zero Trust
Edit this page on GitHub
Set theme to dark (⇧+D)

Run as a service on 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.

    $ cloudflared service install
  2. Start the service.

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

    $ 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:

$ systemctl restart cloudflared