How to Install argocd CLI Ubuntu 25.10

The ArgoCD CLI (argocd) lets you interact with your ArgoCD server directly from the terminal — ideal for managing deployments, syncing apps, or automating GitOps workflows. Here’s how to install it quickly on Ubuntu 25.10.

Step 1: Update System Packages

Start with a clean system update to make sure your repositories and dependencies are current:

sudo apt update && sudo apt upgrade -y

Step 2: Download the Latest ArgoCD CLI Binary

Use curl to fetch the latest stable release directly from GitHub:

curl -sSL -o argocd https://github.com/argoproj/argo-cd/releases/latest/download/argocd-linux-amd64

This downloads the newest version compatible with your system’s architecture.

Step 3: Move Binary to System Path

Make the binary executable and move it into your system’s $PATH so you can run argocd from anywhere:

chmod +x argocd
sudo mv argocd /usr/local/bin/

Step 4: Verify Installation

Check that ArgoCD CLI is installed correctly and working:

argocd version

You should see output similar to:

argocd: v2.12.0+<commit-hash>
  BuildDate: 2025-09-25T00:00:00Z
  GitCommit: <hash>
  GitTreeState: clean
  GoVersion: go1.22.4

Step 5: Connect to Your ArgoCD Server

Once your ArgoCD server is running, log in to it via CLI:

argocd login <ARGOCD_SERVER> --username admin --password <YOUR_PASSWORD> --insecure

Example:

argocd login 192.168.1.100:31443 --username admin --password MySecurePass --insecure

If your ArgoCD server uses HTTPS with a valid certificate, remove the --insecure flag.

Step 6: Test Connection and List Applications

Once logged in, test that the connection works:

argocd app list

If you see your deployed apps listed, the CLI is properly connected.

Optional Step: Auto-Completion (Recommended)

To enable shell auto-completion for faster commands:

echo "source <(argocd completion bash)" >> ~/.bashrc
source ~/.bashrc

For Zsh users:

echo "source <(argocd completion zsh)" >> ~/.zshrc
source ~/.zshrc

Always keep your CLI version close to your ArgoCD server version to avoid compatibility issues:

argocd version --short