Skip to content

Installation

Non-production installation

If you just want to try out Argo Workflows in a non-production environment (including on desktop via minikube/kind/k3d etc) follow the quick-start guide.

Production installation

Installation Methods

Official release manifests

To install Argo Workflows, navigate to the releases page and find the release you wish to use (the latest full release is preferred). Scroll down to the Controller and Server section and execute the kubectl commands.

You can use Kustomize to patch your preferred configurations on top of the base manifest.

Use a full hash

If you are using a remote base with Kustomize, you should specify a full commit hash, for example ?ref=960af331a8c0a3f2e263c8b90f1daf4303816ba8.

latest vs stable

latest is the tip of the main branch and may not be stable. In production, you should use a specific release version.

Argo Workflows Helm Chart

You can install Argo Workflows using the community maintained Helm charts.

Installation options

Determine your base installation option.

  • A cluster install will watch and execute workflows in all namespaces. This is the default installation option when installing using the official release manifests.
  • A namespace install only executes workflows in the namespace it is installed in (typically argo). Look for namespace-install.yaml in the release assets.
  • A managed namespace install: only executes workflows in a separate namespace from the one it is installed in. See Managed Namespace for more details.

Additional installation considerations

Review the following:


Have a question?

Search on GitHub Discussions and Slack.