Skip to main content

Declarative GitOps continuous delivery for Kubernetes

Argo CD automates the deployment of applications to Kubernetes clusters, using Git repositories as the source of truth for defining the desired application state.

Get startedCore concepts

Why Argo CD?

Application definitions, configurations, and environments should be declarative and version controlled. Application deployment and lifecycle management should be automated, auditable, and easy to understand.

GitOps Native

Git as the single source of truth for declarative infrastructure and applications. Every change is tracked, auditable, and reversible.

Multi-Cluster

Deploy and manage applications across multiple Kubernetes clusters from a single control plane with ease.

Automated Sync

Automatically sync applications with Git repositories. Detect configuration drift and trigger deployments on commit.

Quick start

Get Argo CD up and running in minutes with these simple steps.

1

Install Argo CD

Create the Argo CD namespace and install the components:
kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
This installs Argo CD into the argocd namespace with all required components including the API server, repository server, and application controller.
2

Access the Argo CD API server

Port-forward the API server to access the UI:
kubectl port-forward svc/argocd-server -n argocd 8080:443
The UI will be available at https://localhost:8080. The default username is admin.
3

Get the initial admin password

Retrieve the auto-generated admin password:
kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d
Use this password to log in to the Argo CD UI or CLI. Change it after your first login.
4

Create your first application

Deploy a sample application using the CLI or UI:
argocd app create guestbook \
  --repo https://github.com/argoproj/argocd-example-apps.git \
  --path guestbook \
  --dest-server https://kubernetes.default.svc \
  --dest-namespace default
Sync the application to deploy it to your cluster:
argocd app sync guestbook

Explore by topic

Dive deeper into Argo CD’s capabilities and learn how to configure and operate it effectively.

Core concepts

Learn about applications, sync status, health checks, and the GitOps workflow that powers Argo CD.

Architecture

Understand Argo CD’s component architecture and how it integrates with Kubernetes clusters.

Installation

Install Argo CD in different modes including high availability and core-only configurations.

ApplicationSets

Automate application creation across multiple clusters and repositories with ApplicationSets.

CLI reference

Explore the argocd CLI commands for managing applications, clusters, and repositories.

API reference

Access the gRPC and REST API documentation for programmatic interaction with Argo CD.

Key features

Powerful capabilities for managing Kubernetes applications at scale.

Multi-tenancy & RBAC

Project-based isolation with fine-grained access control

SSO Integration

OIDC, SAML, OAuth2, LDAP, and GitHub/GitLab authentication

Multiple Config Management Tools

Support for Kustomize, Helm, Jsonnet, and plain YAML

Webhooks & Event Notifications

Integrate with Slack, Teams, and other notification services

Health Assessment

Built-in health checks for common Kubernetes resources

Automated Drift Detection

Continuously monitor and detect configuration drift from Git

Ready to get started?

Install Argo CD on your Kubernetes cluster and start deploying applications using GitOps principles in minutes.

Get started now