agent safety

Agent safety answer

cloudflared manages tunnels, DNS-facing connectivity, and Cloudflare access paths.

Credential access

Reads tunnel credentials, Cloudflare tokens, and local tunnel config.

Remote mutation

Can create tunnels, route traffic, and update service exposure.

Publish/artifact risk

Can expose local or internal services to the network.

Recommended control

Gate tunnel creation, route changes, token use, and service exposure.

Agent-use guidance

Allow tunnel status checks; require approval before exposing endpoints or changing routes.

install

Additional install commands

macOS

Homebrewverified · 100%

brew install cloudflared

provider-native install command

overview

Package summary

Cloudflare Tunnel client (formerly Argo Tunnel)

Project links

Commands and aliases

cloudflared

history

Project history and usage

cloudflared is Cloudflare's Tunnel client, the daemon/CLI that establishes outbound-only connections from private infrastructure to Cloudflare's network. It grew out of the Argo Tunnel product line and became a central piece of Cloudflare One and Zero Trust access patterns.

Project history

The official cloudflared repository was created in 2017, matching the period when Cloudflare was turning Argo Tunnel into a packaged client. Cloudflare now documents Cloudflare Tunnel as a connector that lets origins and private networks reach Cloudflare without opening inbound firewall ports.

The tool's role expanded from origin tunneling for web apps into a general Zero Trust connector: it can run as a service, authenticate tunnels with credential files, and support remotely managed tunnels through Cloudflare's dashboard and API.

Adoption history

cloudflared has unusually broad package-manager coverage for a vendor network daemon. The batch package metadata lists apk, Homebrew, Chocolatey, MacPorts, Nix, pacman, Scoop, winget, and zypper, reflecting demand across Linux servers, macOS developer machines, and Windows desktops.

Cloudflare's documentation and release cadence make cloudflared a common dependency in homelab, self-hosting, Kubernetes, CI, and enterprise Zero Trust deployments where operators want a reverse tunnel without exposing origin services directly.

How it is used

Operators use cloudflared to create, run, and supervise Cloudflare Tunnel connectors. Typical workflows include logging in, creating a tunnel, writing config.yml, storing a tunnel credentials JSON file, and running cloudflared as a foreground process or system service.

The same executable also covers DNS-over-HTTPS proxying and other Cloudflare network utility tasks, but the Homebrew package is primarily significant as the Cloudflare Tunnel client.

Why package nerds care

cloudflared is a good example of a cloud vendor shipping a cross-platform networking daemon through mainstream package managers instead of only tarballs or curl-piped installers. Formula maintainers care about service integration, binary update speed, and config/credential paths because it is often run unattended.

Its packaging surface is broader than many cloud CLIs because it serves both developers and infrastructure operators: the same package can be used interactively on a laptop or as a long-running connector on a server.

Timeline

2017: Official cloudflared GitHub repository was created.
2020: Public GitHub releases for cloudflared were available in the 2020.6.x line.
2022: Cloudflare Tunnel became part of the broader Cloudflare One connector documentation and product surface.
2026: cloudflared continued a date-versioned release cadence, including 2026.6.x releases.

Related projects

Cloudflare Tunnel is the product surface that cloudflared implements as a connector.
Cloudflare Access and Zero Trust policies commonly sit in front of applications exposed through cloudflared.
Wrangler overlaps in the Cloudflare CLI ecosystem but is focused on Workers development rather than tunnel operations.

Sources

security posture

Risk level: orange

formula declares a Homebrew service. infrastructure mutation or orchestration signal.

Risk classifier

orange risk · medium confidence · infrastructure

Why

formula declares a Homebrew service
infrastructure mutation or orchestration signal

Signals

metadata:service
text:cloud

Install behavior

No Homebrew bottle metadata was recorded.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix: ~/.cloudflared/config.yml$XDG_CONFIG_HOME/cloudflared/config.yml~/.config/cloudflared/config.yml

Credential files

Credential-bearing paths to review before unattended agent runs.

Unix: ~/.cloudflared/cert.pem~/.cloudflared/*.json$XDG_CONFIG_HOME/cloudflared/cert.pem$XDG_CONFIG_HOME/cloudflared/*.json~/.config/cloudflared/cert.pem~/.config/cloudflared/*.json

executables

Installed executables

Command	Kind	Exposure	Note
`cloudflared`	executable	indexed executable	Discovered from the local executable index.

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-08-03

manager version2026.7.3

manager updated2026-07-23

local dataunknown

upstreamnot available

latest detectednot detected

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:cloudflared
Version	2026.7.3
Package manager	Homebrew
Homepage	https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/
Repository	https://github.com/cloudflare/cloudflared
Last updated	2026-07-23T12:10:11Z
Pulse	updated
Bottle	not recorded
Service	none declared

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/cloudflared.yml

Used sources

Geiger risk classifier
Nucleus package database
curated agent safety answer
curated configuration and credential file locations
curated package history
pkgdb category and tag curation

Install cloudflared with Homebrew