Skip to content
Cloudflare Docs

Linux

You can install cloudflared as a system service on Linux.

Prerequisites

Section titled “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

Section titled “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

Section titled “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

Section titled “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