argocd

What is argocd?

The argocd image runs Argo CD, a declarative, GitOps-based continuous delivery (CD) tool for Kubernetes. It watches Git repositories for changes to Kubernetes manifests and automatically synchronizes them to the cluster, ensuring that the desired state in Git matches the actual state in the cluster.

The image includes the Argo CD API server, UI, CLI, and controller components. It's designed to be deployed inside a Kubernetes cluster, typically as a full GitOps control plane. Argo CD supports multi-cluster deployments, role-based access control, automated sync strategies, and integration with Kustomize, Helm, and plain YAML.

The argocd image is widely used by platform teams to automate deployment workflows, enforce infrastructure consistency, and improve auditability through Git.

How to use this image

Argo CD is usually deployed via manifests or Helm and runs as a set of services inside your Kubernetes cluster.

Install Argo CD into a Kubernetes cluster:

<code>kubectl create namespace argocdkubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml</code>

Port-forward to access the UI:

<code>kubectl port-forward svc/argocd-server -n argocd 8080:443</code>

Log in with the CLI (using the image):

<code>docker run --rm -e ARGOCD_OPTS="--insecure" \  --network=host argoproj/argocd:v2.10.4 \  argocd login localhost:8080 --username admin --password <password></code>

Common usage:

• Automatically sync Git changes to Kubernetes
• Promote apps between environments via Git pull requests
• Visualize app health, sync status, and deployment history via the web UI or CLI

Logging and ports:

‍Argo CD logs to stdout by default. The UI/API server listens on port 443 within the cluster; port 8080 is typically used for local port-forwarding.

Image variants

Published under argoproj/argocd, the image includes all Argo CD components (server, repo server, application controller, dex, etc.). No OS-specific variants are published.

argoproj/argocd:latest

Latest stable release with all services included.Suitable for dev environments or quick testing.

argoproj/argocd:<version>

Tagged by release (e.g. v2.10.4, v2.9.3).

Recommended for production deployments to ensure version consistency across CLI and controller components.

Argo CD also publishes related component images (e.g. argocd-application-controller, argocd-repo-server) but the full argocd image is the most commonly used for CLI and quick access tasks.