argocd(1)
ArgoCd is a declarative, GitOps continuous delivery tool for Kubernetes that automates application deployment from Git repositories.
Synopsis
argocd [COMMAND] [OPTIONS]Description
ArgoCD is a declarative continuous delivery tool that uses Git repositories as the single source of truth for application state. It monitors your Git repositories and automatically applies changes to your Kubernetes clusters, enabling GitOps workflows at scale.
The argocd CLI tool provides full management of ArgoCD server instances, including authentication, application deployment, cluster configuration, and monitoring. Use it to create applications, manage projects, inspect application status, and synchronize desired state with live clusters.
Common options
| Flag | What it does |
|---|---|
--server | ArgoCD server address (e.g., localhost:8080 or argocd.example.com) |
--auth-token | Authentication token for API access; overrides stored credentials |
--username | Username for authentication; commonly 'admin' for initial setup |
--password | Password for authentication; use interactively or with environment variables |
--insecure | Skip TLS certificate verification (development only) |
--grpc-web | Use gRPC web transport instead of native gRPC |
--core | Connect to core ArgoCD server in-cluster without external network |
--help, -h | Show help message and exit |
Examples
Authenticate to an ArgoCD server and save credentials locally
argocd login argocd.example.com --username admin --password mypasswordCreate a new ArgoCD application pointing to a Git repository and target Kubernetes cluster
argocd app create myapp --repo https://github.com/user/repo --path ./helm --dest-server https://kubernetes.default.svc --dest-namespace defaultDisplay all applications managed by the connected ArgoCD server
argocd app listSynchronize an application's live state with the desired state in Git
argocd app sync myappShow detailed information about a specific application including sync status
argocd app get myappRegister a Kubernetes cluster with ArgoCD for deployment targets
argocd cluster add my-clusterList all projects for organizing applications with RBAC policies
argocd proj listRemove an application and optionally delete associated resources from the cluster
argocd app delete myapp --cascade