# Install argocd with Homebrew, apk, MacPorts, Nix, pacman, scoop, winget

GitOps Continuous Delivery for Kubernetes. Version 3.4.6 via Homebrew; verified 2026-07-31. Also installable with nix: nix profile install nixpkgs#argocd.

## 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
- **Version:** 3.4.6
- **Source summary:** GitOps Continuous Delivery for Kubernetes
- **Homepage:** <https://argoproj.github.io/cd/>
- **Repository:** <https://github.com/argoproj/argo-cd>
- **Last updated:** 2026-07-31T15:10:55Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- argocd (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 3.4.6
## 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

- <https://argo-cd.readthedocs.io/en/stable/user-guide/commands/argocd/>
- <https://github.com/argoproj/argo-cd>
- <https://raw.githubusercontent.com/argoproj/argo-cd/master/USERS.md>
- <https://www.cncf.io/projects/argo/>


## 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
## 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-r2: 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-r2: 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-r2: 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-r2: 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


## Combined YAML source

View the package source record on GitHub. [combined/argocd.yml](https://github.com/mxcl/pkgdb/blob/main/combined/argocd.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
- curated agent safety answer