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

local Homebrew formula metadata

MacPortsverified · 94%

sudo port install cloudflared

MacPorts ports tree · net/cloudflared/Portfile · source: api.github.com

Linux

Alpine Linux apkverified · 92%

sudo apk add cloudflared

Alpine Linux edge package indexes · cloudflared · source: dl-cdn.alpinelinux.org

Nixverified · 92%

nix profile install nixpkgs#cloudflared

nixpkgs package indexes · pkgs/by-name/cl/cloudflared/package.nix · source: api.github.com

Arch Linux pacmanverified · 92%

sudo pacman -S cloudflared

Arch Linux sync databases · cloudflared · source: geo.mirror.pkgbuild.com

openSUSE zypperverified · 92%

sudo zypper install cloudflared

openSUSE Tumbleweed package metadata · cloudflared · source: download.opensuse.org

Windows

Chocolateyverified · 92%

choco install cloudflared

Chocolatey community package catalog · cloudflared · source: community.chocolatey.org

Scoopverified · 92%

scoop install main/cloudflared

Scoop official bucket manifest trees · bucket/cloudflared.json · source: api.github.com

Windows Package Managerverified · 92%

winget install --id Cloudflare.cloudflared -e

Windows Package Manager source index · Cloudflare.cloudflared · source: cdn.winget.microsoft.com

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 post-install hook is recorded in formula metadata.
Formula metadata declares a service or daemon block.
Homebrew bottle metadata is available for 6 platform targets.
Build metadata lists 1 build dependencies.

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`	cli	global executable

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-07-08

manager version2026.6.1

manager updated2026-06-18

local dataok

upstreamcurrent

latest detected2026.6.1

https://github.com/cloudflare/cloudflared

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:cloudflared
Version	2026.6.1
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/cloudflared
Homepage	https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/
Repository	https://github.com/cloudflare/cloudflared
Upstream docs	https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel
License	Apache-2.0
Source archive	https://github.com/cloudflare/cloudflared/archive/refs/tags/2026.6.1.tar.gz
Last updated	2026-06-18T15:38:07Z
Pulse	updated
Build dependencies	go
Bottle	available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	not defined
Service	declared

registry facts

Source database details

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	cloudflared
Version Scheme	0
Revision	0
Head Version	HEAD
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	head stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix95%

cloudflared

nix profile install nixpkgs#cloudflared

normalized package name match
Matched by: Cloudflared

nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/cl/cloudflared/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

apk95%

cloudflared 2026.6.0-r0

Cloudflare Tunnel client

https://github.com/cloudflare/cloudflared

sudo apk add cloudflared

License: Apache-2.0
Architecture: x86_64
Source Package: cloudflared
1 dependencies
1 provides
normalized package name match
Matched by: Cloudflared

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: cloudflared from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz

apk95%

cloudflared-doc 2026.6.0-r0

Cloudflare Tunnel client (documentation)

https://github.com/cloudflare/cloudflared

sudo apk add cloudflared-doc

License: Apache-2.0
Architecture: x86_64
Source Package: cloudflared
normalized package name match
Matched by: Cloudflared

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: cloudflared-doc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz

apk95%

cloudflared-openrc 2026.6.0-r0

Cloudflare Tunnel client (OpenRC init scripts)

https://github.com/cloudflare/cloudflared

sudo apk add cloudflared-openrc

License: Apache-2.0
Architecture: x86_64
Source Package: cloudflared
normalized package name match
Matched by: Cloudflared

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: cloudflared-openrc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz

pacman95%

cloudflared 2026.6.0-1

Command-line client for Cloudflare Tunnel

https://github.com/cloudflare/cloudflared

sudo pacman -S cloudflared

License: Apache-2.0
Architecture: x86_64
1 dependencies
normalized package name match
Matched by: Cloudflared

Arch Linux sync databases · geo.mirror.pkgbuild.com · Arch Linux sync databases: cloudflared from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

zypper95%

cloudflared 2026.5.2-1.1

Cloudflare Tunnel client

https://github.com/cloudflare/cloudflared

sudo zypper install cloudflared

License: Apache-2.0
Category: Productivity/Networking/System
Architecture: x86_64
Source Package: cloudflared
1 provides
normalized package name match
Matched by: Cloudflared

openSUSE Tumbleweed package metadata · download.opensuse.org · openSUSE Tumbleweed package metadata: cloudflared from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

MacPorts95%

cloudflared

sudo port install cloudflared

normalized package name match
Matched by: Cloudflared

MacPorts ports tree · api.github.com · MacPorts ports tree: net/cloudflared/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

Chocolatey95%

cloudflared

choco install cloudflared

normalized package name match
Matched by: Cloudflared

Chocolatey community package catalog · community.chocolatey.org · Chocolatey community package catalog: cloudflared from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','chocolatey-preinstaller-checks.extension'

Scoop95%

main/cloudflared

scoop install main/cloudflared

normalized package name match
Matched by: Cloudflared

Scoop official bucket manifest trees · api.github.com · Scoop official bucket manifest trees: bucket/cloudflared.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

winget95%

Cloudflare.cloudflared

winget install --id Cloudflare.cloudflared -e

normalized package name match
Matched by: Cloudflared

Windows Package Manager source index · cdn.winget.microsoft.com · Windows Package Manager source index: Cloudflare.cloudflared from https://cdn.winget.microsoft.com/cache/source.msix

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
av.db category and tag curation
cross-ecosystem install command graph
curated agent safety answer
curated configuration and credential file locations
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment

Install cloudflared with Homebrew, apk, chocolatey, MacPorts, Nix, pacman, scoop, winget, zypper

Agent safety answer

Credential access

Remote mutation

Publish/artifact risk

Recommended control

Agent-use guidance

Additional install commands

macOS

Linux

Windows

Package summary

Project links

Commands and aliases

Project history and usage

Project history

Adoption history

How it is used

Why package nerds care

Timeline

Related projects

Sources

Risk level: orange

Risk classifier

Why

Signals

Install behavior

Recommended review

Configuration and credential file locations

Configuration files

Credential files

Installed executables

Version and freshness

Package metadata

Source database details

Other package-manager records

Internal package links

Topical hubs

Related tools

Same workflow

Agent security guides

Generated from repository data

Combined YAML source

Used sources