CLI Installation

Install the Argo CD command-line interface on Linux, macOS, Windows, and WSL

The Argo CD CLI (argocd) is a powerful command-line tool for managing Argo CD applications, repositories, clusters, and projects. This page covers installation methods for all major operating systems.

Linux and WSL

ArchLinux

Install via the package manager:

pacman -S argocd

Homebrew

If you have Homebrew installed on Linux:

brew install argocd

Download With Curl

Latest Version

Download and install the latest release:

curl -sSL -o argocd-linux-amd64 https://github.com/argoproj/argo-cd/releases/latest/download/argocd-linux-amd64
sudo install -m 555 argocd-linux-amd64 /usr/local/bin/argocd
rm argocd-linux-amd64

Specific Version

Set VERSION to your desired release tag:

VERSION=v2.10.0  # Replace with desired version
curl -sSL -o argocd-linux-amd64 https://github.com/argoproj/argo-cd/releases/download/$VERSION/argocd-linux-amd64
sudo install -m 555 argocd-linux-amd64 /usr/local/bin/argocd
rm argocd-linux-amd64

Latest Stable

Download the latest stable version:

VERSION=$(curl -L -s https://raw.githubusercontent.com/argoproj/argo-cd/stable/VERSION)
curl -sSL -o argocd-linux-amd64 https://github.com/argoproj/argo-cd/releases/download/v$VERSION/argocd-linux-amd64
sudo install -m 555 argocd-linux-amd64 /usr/local/bin/argocd
rm argocd-linux-amd64

macOS

Homebrew (Recommended)

The easiest way to install on macOS:

brew install argocd

Download With Curl

Apple Silicon (M1/M2/M3)

VERSION=$(curl --silent "https://api.github.com/repos/argoproj/argo-cd/releases/latest" | grep '"tag_name"' | sed -E 's/.*"([^"]+)".*/\1/')
curl -sSL -o argocd https://github.com/argoproj/argo-cd/releases/download/$VERSION/argocd-darwin-arm64
sudo install -m 555 argocd /usr/local/bin/argocd
rm argocd

Intel (x86_64)

VERSION=$(curl --silent "https://api.github.com/repos/argoproj/argo-cd/releases/latest" | grep '"tag_name"' | sed -E 's/.*"([^"]+)".*/\1/')
curl -sSL -o argocd https://github.com/argoproj/argo-cd/releases/download/$VERSION/argocd-darwin-amd64
sudo install -m 555 argocd /usr/local/bin/argocd
rm argocd

Windows

Download With PowerShell

Download the latest version:

$version = (Invoke-RestMethod https://api.github.com/repos/argoproj/argo-cd/releases/latest).tag_name
$url = "https://github.com/argoproj/argo-cd/releases/download/" + $version + "/argocd-windows-amd64.exe"
$output = "argocd.exe"

Invoke-WebRequest -Uri $url -OutFile $output

Add to PATH

Add the Argo CD CLI to your PATH environment variable:

[Environment]::SetEnvironmentVariable("Path", "$env:Path;C:\Path\To\ArgoCD-CLI", "User")

Replace C:\Path\To\ArgoCD-CLI with the actual directory where you saved argocd.exe.

Verify Installation

After installation, verify that the CLI is working:

argocd version --client

You should see output similar to:

argocd: v2.10.0+c23e1e8
  BuildDate: 2024-01-15T18:30:14Z
  GitCommit: c23e1e8a4c5c77c6e5c4e0c6e5c4e0c6e5c4e0c6
  GitTreeState: clean
  GoVersion: go1.21.6
  Compiler: gc
  Platform: linux/amd64

Next Steps

CLI Overview

Learn CLI basics and authentication

App Commands

Manage applications with the CLI