# Install argocd with Homebrew, apk, MacPorts, Nix, pacman, scoop, winget GitOps Continuous Delivery for Kubernetes. Version 3.4.4 via Homebrew; verified 2026-06-18. ## Install ```sh sudo av install brew:argocd ``` ## Agent safety answer argocd controls GitOps applications and live cluster deployment state. - **Credential access:** Reads Argo CD tokens, kubeconfig, and repository credentials. - **Remote mutation:** Can sync, rollback, delete, and change applications. - **Publish/artifact risk:** Can deploy Git-sourced artifacts into clusters. - **Recommended control:** Gate sync, app delete, rollback, and credential commands. - **Agent-use guidance:** Allow app status reads; require approval for syncs, deletes, and project changes. Additional install commands: ### macOS - Homebrew (100%): ```sh brew install argocd ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install argocd ``` Evidence: MacPorts ports tree: devel/argocd/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add argocd ``` Evidence: Alpine Linux edge package indexes: argocd from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz - Nix (92%): ```sh nix profile install nixpkgs#argocd ``` Evidence: nixpkgs package indexes: pkgs/by-name/ar/argocd/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S argocd ``` Evidence: Arch Linux sync databases: argocd from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz ### Windows - Scoop (92%): ```sh scoop install main/argocd ``` Evidence: Scoop official bucket manifest trees: bucket/argocd.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget (92%): ```sh winget install --id argoproj.argocd -e ``` Evidence: Windows Package Manager source index: argoproj.argocd from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:argocd - **Package manager:** Homebrew - **Package manager page:** - **Version:** 3.4.4 - **Source summary:** GitOps Continuous Delivery for Kubernetes - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-06-18T13:22:09Z - **Generated:** 2026-07-09T07:20:21+00:00 ## Executables - argocd (cli) - argocd (alias) ## Build dependencies - go - node - yarn ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-09 - Package-manager version: 3.4.4 - Package-manager updated: 2026-06-18 - Local data: ok - Upstream repository: https://github.com/argoproj/argo-cd - info: No cached GitHub release or tag data was available. ## Project history and usage Argo CD is a declarative GitOps continuous delivery system for Kubernetes. It continuously compares application definitions stored in Git with the live cluster state and drives Kubernetes resources toward the declared desired state. ### Project history Argo CD is part of the Argo project family. The upstream README describes the project as declarative continuous delivery for Kubernetes and emphasizes version-controlled application definitions plus automated, auditable lifecycle management. CNCF records Argo as accepted on March 26, 2020 at the Incubating maturity level and promoted to Graduated on December 6, 2022. That graduation is the official marker that Argo, including Argo CD as the best-known GitOps component, had become stable and broadly adopted in cloud-native production environments. ### Adoption history Argo CD adoption grew with GitOps and Kubernetes platform engineering. The upstream repository maintains an official users list with hundreds of organizations and the CNCF project page links case studies and project insights, indicating use by large enterprises, cloud-native vendors, universities, and platform teams. Its package-manager footprint reflects that adoption: the input records Homebrew, apk, MacPorts, Nix, pacman, Scoop, and WinGet packages, which is typical for a CLI that developers run locally while operators deploy the controller in clusters. ### How it is used The `argocd` CLI is used to log in to an Argo CD API server, manage application definitions, sync or inspect applications, switch contexts, and configure local client state. Official command docs show the client config path defaulting to an XDG-style `argocd/config` file and the `argocd configure` command managing local configuration. Operationally, package users often install the CLI with Homebrew for day-to-day interaction while installing the controller via manifests or Helm in Kubernetes. The package is therefore both a workstation tool and a control-plane companion. ### Why package nerds care Argo CD is one of the packages that made `brew install argocd` feel normal for Kubernetes operators: a Go CLI with frequent releases, completions, auth material in a local config file, and tight coupling to a Kubernetes-native controller. It also represents a modern packaging split: the formula supplies the CLI binary, while most runtime deployment happens through Kubernetes YAML or Helm charts. That split is common for cloud-native tools but still important for reproducible developer laptops and automation runners. ### Timeline - 2020-03-26: Argo accepted into CNCF at Incubating maturity. - 2022-12-06: Argo promoted to CNCF Graduated maturity. - Current: Upstream README lists Argo CD as declarative GitOps continuous delivery for Kubernetes and links official docs, user list, releases, and community channels. ### Related projects - Other Argo projects include Argo Workflows, Argo Rollouts, and Argo Events. - Argo CD Image Updater, ApplicationSet, Helm, Kustomize, and config-management plugins are common ecosystem companions. ### Sources - - - - ## Security Notes infrastructure mutation or orchestration signal. - **Geiger risk:** orange / medium - 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: ~/.argocd/config, $XDG_CONFIG_HOME/argocd/config, ~/.config/argocd/config ## Credential files - Unix: ~/.argocd/config, $XDG_CONFIG_HOME/argocd/config, ~/.config/argocd/config ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** argocd - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Nix - argocd: normalized package name match | nixpkgs package indexes: pkgs/by-name/ar/argocd/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - apk - argocd - 3.4.1-r1: normalized package name match | Alpine Linux edge package indexes: argocd from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Declarative continuous deployment for Kubernetes | https://argo-cd.readthedocs.io/ - apk - argocd-bash-completion - 3.4.1-r1: normalized package name match | Alpine Linux edge package indexes: argocd-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Bash completions for argocd | https://argo-cd.readthedocs.io/ - apk - argocd-doc - 3.4.1-r1: normalized package name match | Alpine Linux edge package indexes: argocd-doc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Declarative continuous deployment for Kubernetes (documentation) | https://argo-cd.readthedocs.io/ - apk - argocd-zsh-completion - 3.4.1-r1: normalized package name match | Alpine Linux edge package indexes: argocd-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Zsh completions for argocd | https://argo-cd.readthedocs.io/ - pacman - argocd - 3.4.2-1: normalized package name match | Arch Linux sync databases: argocd from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Declarative continuous deployment for Kubernetes | https://argo-cd.readthedocs.io/en/stable/ - MacPorts - argocd: normalized package name match | MacPorts ports tree: devel/argocd/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Scoop - main/argocd: normalized package name match | Scoop official bucket manifest trees: bucket/argocd.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget - argoproj.argocd: normalized package name match | Windows Package Manager source index: argoproj.argocd 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. - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control 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. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [node](https://www.automicvault.com/pkg/brew/node/) - Build dependency declared by Homebrew. - [yarn](https://www.automicvault.com/pkg/brew/yarn/) - Build dependency declared by Homebrew. - [argocd-autopilot](https://www.automicvault.com/pkg/brew/argocd-autopilot/) - Shares av.db curated category or tags: cli, cloud-infrastructure, gitops, kubernetes. - [cozyhr](https://www.automicvault.com/pkg/brew/cozyhr/) - Shares av.db curated category or tags: cli, cloud-infrastructure, gitops, kubernetes. - [fleet-cli](https://www.automicvault.com/pkg/brew/fleet-cli/) - Shares av.db curated category or tags: cli, cloud-infrastructure, gitops, kubernetes. - [glasskube](https://www.automicvault.com/pkg/brew/glasskube/) - Shares av.db curated category or tags: cli, cloud-infrastructure, gitops, kubernetes. - [kubefirst](https://www.automicvault.com/pkg/brew/kubefirst/) - Shares av.db curated category or tags: cli, cloud-infrastructure, gitops, kubernetes. - [nelm](https://www.automicvault.com/pkg/brew/nelm/) - Shares av.db curated category or tags: cli, cloud-infrastructure, gitops, kubernetes. - [talhelper](https://www.automicvault.com/pkg/brew/talhelper/) - Shares av.db curated category or tags: cli, cloud-infrastructure, gitops, kubernetes. - [talm](https://www.automicvault.com/pkg/brew/talm/) - Shares av.db curated category or tags: cli, cloud-infrastructure, gitops, kubernetes. - [argocd-mcp](https://www.automicvault.com/pkg/npm/argocd-mcp/) - Local package facts share a topical domain. Shared terms: argocd, cli, cloud, cloud-infrastructure, gitops. - [argocd-vault-plugin](https://www.automicvault.com/pkg/brew/argocd-vault-plugin/) - Package names and metadata indicate a similar tool family. Shared terms: argocd, cli, cloud, cloud-infrastructure, infrastructure. ## Combined YAML source View the package source record on GitHub. [combined/argocd.yml](https://github.com/automic-vault/db/blob/main/combined/argocd.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