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 started Core concepts

              
                {`apiVersion: argoproj.io/v1alpha1
                                kind: Application
                                metadata:
                                name: guestbook
                                namespace: argocd
                                spec:
                                project: default
                                source:
                                  repoURL: https://github.com/argoproj/argocd-example-apps
                                  targetRevision: HEAD
                                  path: guestbook
                                destination:
                                  server: https://kubernetes.default.svc
                                  namespace: guestbook`}

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.

Create the Argo CD namespace and install the components: ```bash theme={null} 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. Port-forward the API server to access the UI: ```bash theme={null} kubectl port-forward svc/argocd-server -n argocd 8080:443 ``` The UI will be available at `https://localhost:8080`. The default username is `admin`. Retrieve the auto-generated admin password: ```bash theme={null} 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. Deploy a sample application using the CLI or UI: ```bash theme={null} 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: ```bash theme={null} argocd app sync guestbook ```

Explore by topic

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

Learn about applications, sync status, health checks, and the GitOps workflow that powers Argo CD. Understand Argo CD's component architecture and how it integrates with Kubernetes clusters. Install Argo CD in different modes including high availability and core-only configurations. Automate application creation across multiple clusters and repositories with ApplicationSets. Explore the argocd CLI commands for managing applications, clusters, and repositories. 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