# Install cloudflared with Homebrew, apk, chocolatey, MacPorts, Nix, pacman, scoop, winget, zypper Cloudflare Tunnel client (formerly Argo Tunnel). Version 2026.6.1 via Homebrew; verified 2026-06-18. ## Install ```sh sudo av install brew:cloudflared ``` ## 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. Additional install commands: ### macOS - Homebrew (100%): ```sh brew install cloudflared ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install cloudflared ``` Evidence: MacPorts ports tree: net/cloudflared/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add cloudflared ``` Evidence: Alpine Linux edge package indexes: cloudflared from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz - Nix (92%): ```sh nix profile install nixpkgs#cloudflared ``` Evidence: nixpkgs package indexes: pkgs/by-name/cl/cloudflared/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S cloudflared ``` Evidence: Arch Linux sync databases: cloudflared from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install cloudflared ``` Evidence: openSUSE Tumbleweed package metadata: cloudflared from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ### Windows - Chocolatey (92%): ```sh choco install cloudflared ``` Evidence: 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' - Scoop (92%): ```sh scoop install main/cloudflared ``` Evidence: Scoop official bucket manifest trees: bucket/cloudflared.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget (92%): ```sh winget install --id Cloudflare.cloudflared -e ``` Evidence: Windows Package Manager source index: Cloudflare.cloudflared from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:cloudflared - **Package manager:** Homebrew - **Package manager page:** - **Version:** 2026.6.1 - **Source summary:** Cloudflare Tunnel client (formerly Argo Tunnel) - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-06-18T15:38:07Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - cloudflared (cli) - cloudflared (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Service: declared - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 2026.6.1 - Package-manager updated: 2026-06-18 - Local data: ok - Upstream repository: https://github.com/cloudflare/cloudflared - Upstream latest detected: 2026.6.1 (current) ## 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 Notes formula declares a Homebrew service. infrastructure mutation or orchestration signal. - **Geiger risk:** orange / medium - formula declares a Homebrew service - infrastructure mutation or orchestration signal ## 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 - Unix: ~/.cloudflared/config.yml, $XDG_CONFIG_HOME/cloudflared/config.yml, ~/.config/cloudflared/config.yml ## Credential files - Unix: ~/.cloudflared/cert.pem, ~/.cloudflared/*.json, $XDG_CONFIG_HOME/cloudflared/cert.pem, $XDG_CONFIG_HOME/cloudflared/*.json, ~/.config/cloudflared/cert.pem, ~/.config/cloudflared/*.json ## 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:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - cloudflared: normalized package name match | nixpkgs package indexes: pkgs/by-name/cl/cloudflared/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - apk - cloudflared - 2026.6.0-r0: normalized package name match | Alpine Linux edge package indexes: cloudflared from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Cloudflare Tunnel client | https://github.com/cloudflare/cloudflared - apk - cloudflared-doc - 2026.6.0-r0: normalized package name match | Alpine Linux edge package indexes: cloudflared-doc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Cloudflare Tunnel client (documentation) | https://github.com/cloudflare/cloudflared - apk - cloudflared-openrc - 2026.6.0-r0: normalized package name match | Alpine Linux edge package indexes: cloudflared-openrc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Cloudflare Tunnel client (OpenRC init scripts) | https://github.com/cloudflare/cloudflared - pacman - cloudflared - 2026.6.0-1: normalized package name match | Arch Linux sync databases: cloudflared from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Command-line client for Cloudflare Tunnel | https://github.com/cloudflare/cloudflared - zypper - cloudflared - 2026.5.2-1.1: normalized package name match | openSUSE Tumbleweed package metadata: cloudflared from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Cloudflare Tunnel client | https://github.com/cloudflare/cloudflared - MacPorts - cloudflared: normalized package name match | MacPorts ports tree: net/cloudflared/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Chocolatey - cloudflared: normalized package name match | 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' - Scoop - main/cloudflared: normalized package name match | Scoop official bucket manifest trees: bucket/cloudflared.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget - Cloudflare.cloudflared: normalized package name match | Windows Package Manager source index: Cloudflare.cloudflared from https://cdn.winget.microsoft.com/cache/source.msix ## Related links - [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family. - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [proxytunnel](https://www.automicvault.com/pkg/brew/proxytunnel/) - Shares av.db curated category or tags: cli, networking, proxy, tunnel, tunneling. - [sixtunnel](https://www.automicvault.com/pkg/brew/sixtunnel/) - Shares av.db curated category or tags: cli, networking, proxy, tunnel, tunneling. - [zoro](https://www.automicvault.com/pkg/brew/zoro/) - Shares av.db curated category or tags: cli, networking, proxy, tunnel, tunneling. - [autossh](https://www.automicvault.com/pkg/brew/autossh/) - Shares av.db curated category or tags: cli, networking, tunnel, tunneling. - [boring](https://www.automicvault.com/pkg/brew/boring/) - Shares av.db curated category or tags: cli, networking, tunnel, tunneling. - [dns2tcp](https://www.automicvault.com/pkg/brew/dns2tcp/) - Shares av.db curated category or tags: cli, networking, tunnel, tunneling. - [ptunnel](https://www.automicvault.com/pkg/brew/ptunnel/) - Shares av.db curated category or tags: cli, networking, proxy, tunneling. - [rospo](https://www.automicvault.com/pkg/brew/rospo/) - Shares av.db curated category or tags: cli, networking, proxy, tunneling. - [cloudflared](https://www.automicvault.com/pkg/npm/cloudflared/) - Same normalized package name appears in another local ecosystem. Shared terms: cloudflare, cloudflared, tunnel. - [cloudflared](https://www.automicvault.com/pkg/npm/cloudflared/) - Same normalized package name in another local ecosystem. ## Combined YAML source View the package source record on GitHub. [combined/cloudflared.yml](https://github.com/automic-vault/db/blob/main/combined/cloudflared.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph - curated agent safety answer