OS Manuals

/usr/bin/cloudflared

Cloudflare Tunnel client

From cloudflared 2026.5.2-r2 (os), captured 2026-11-05 by running cloudflared --help (exit 0). permalink

Also provided by 2 other package versions
NAME:
   cloudflared - Cloudflare's command-line tool and agent

USAGE:
   cloudflared [global options] [command] [command options]

VERSION:
   2026.5.2 (built unknown)

DESCRIPTION:
   cloudflared connects your machine or user identity to Cloudflare's global network.
     You can use it to authenticate a session to reach an API behind Access, route web traffic to this machine,
     and configure access control.

     See https://developers.cloudflare.com/cloudflare-one/connections/connect-apps for more in-depth documentation.

COMMANDS:
   update     Update the agent if a new version exists
   version    Print the version
   proxy-dns  dns-proxy feature is no longer supported
   tail       Stream logs from a remote cloudflared
   service    Manages the cloudflared system service
   help, h    Shows a list of commands or help for one command
   Access:
     access, forward  access <subcommand>
   Tunnel:
     tunnel  Use Cloudflare Tunnel to expose private services to the Internet or to Cloudflare connected private users.

GLOBAL OPTIONS:
   --output value                               Output format for the logs (default, json) (default: "default") [$TUNNEL_MANAGEMENT_OUTPUT, $TUNNEL_LOG_OUTPUT]
   --proxy-dns                                  (default: false)
   --proxy-dns-port value                       (default: 0)
   --proxy-dns-address value
   --proxy-dns-upstream value                   (accepts multiple inputs)
   --proxy-dns-max-upstream-conns value         (default: 0)
   --proxy-dns-bootstrap value                  (accepts multiple inputs)
   --credentials-file value, --cred-file value  Filepath at which to read/write the tunnel credentials [$TUNNEL_CRED_FILE]
   --region value                               Cloudflare Edge region to connect to. Omit or set to empty to connect to the global region. [$TUNNEL_REGION]
   --edge-ip-version value                      Cloudflare Edge IP address version to connect with. {4, 6, auto} (default: "auto") [$TUNNEL_EDGE_IP_VERSION]
   --edge-bind-address value                    Bind to IP address for outgoing connections to Cloudflare Edge. [$TUNNEL_EDGE_BIND_ADDRESS]
   --label value                                Use this option to give a meaningful label to a specific connector. When a tunnel starts up, a connector id unique to the tunnel is generated. This is a uuid. To make it easier to identify a connector, we will use the hostname of the machine the tunnel is running on along with the connector ID. This option exists if one wants to have more control over what their individual connectors are called.
   --post-quantum, --pq                         When given creates an experimental post-quantum secure tunnel (default: false) [$TUNNEL_POST_QUANTUM]
   --management-diagnostics                     Enables the in-depth diagnostic routes to be made available over the management service (/debug/pprof, /metrics, etc.) (default: true) [$TUNNEL_MANAGEMENT_DIAGNOSTICS]
   --overwrite-dns, -f                          Overwrites existing DNS records with this hostname (default: false) [$TUNNEL_FORCE_PROVISIONING_DNS]
   --help, -h                                   show help (default: false)
   --version, -v, -V                            Print the version (default: false)

COPYRIGHT:
   (c) 2026 Cloudflare Inc.
   Your installation of cloudflared software constitutes a symbol of your signature indicating that you accept
   the terms of the Apache License Version 2.0 (https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/license),
   Terms (https://www.cloudflare.com/terms/) and Privacy Policy (https://www.cloudflare.com/privacypolicy/).
Options (17)
OptionDescriptionSource
--output valueOutput format for the logs (default, json) (default: "default") [$TUNNEL_MANAGEMENT_OUTPUT, $TUNNEL_LOG_OUTPUT]help
--proxy-dns(default: false)help
--proxy-dns-port value(default: 0)help
--proxy-dns-address valuehelp
--proxy-dns-upstream value(accepts multiple inputs)help
--proxy-dns-max-upstream-conns value(default: 0)help
--proxy-dns-bootstrap value(accepts multiple inputs)help
--credentials-file, --cred-file valueFilepath at which to read/write the tunnel credentials [$TUNNEL_CRED_FILE]help
--region valueCloudflare Edge region to connect to.help
--edge-ip-version valueCloudflare Edge IP address version to connect with.help
--edge-bind-address valueBind to IP address for outgoing connections to Cloudflare Edge.help
--label valueUse this option to give a meaningful label to a specific connector.help
--post-quantum, --pqWhen given creates an experimental post-quantum secure tunnel (default: false) [$TUNNEL_POST_QUANTUM]help
--management-diagnosticsEnables the in-depth diagnostic routes to be made available over the management service (/debug/pprof, /metrics, etc.) (default: true) [$TUNNEL_MANAGEMENT_DIAGNOSTICS]help
--overwrite-dns, -fOverwrites existing DNS records with this hostname (default: false) [$TUNNEL_FORCE_PROVISIONING_DNS]help
--help, -hshow help (default: false)help
--version, -v, -VPrint the version (default: false)help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.