A new platform for documentation and tutorials is launching soon.
We are migrating Vault documentation into HashiCorp Developer, our new developer experience.
Important Note: This chart is not compatible with Helm 2. Please use Helm 3.6+ with this chart.
The Vault Helm chart is the recommended way to install and configure Vault on Kubernetes. In addition to running Vault itself, the Helm chart is the primary method for installing and configuring Vault to integrate with other services such as Consul for High Availability (HA) deployments.
This page assumes general knowledge of Helm and how to use it. Using Helm to install Vault requires that Helm is properly installed and configured with your Kubernetes cluster.
»Using the Helm Chart
To use the Helm chart, add the Hashicorp helm repository and check that you have access to the chart:
$ helm repo add hashicorp https://helm.releases.hashicorp.com "hashicorp" has been added to your repositories $ helm search repo hashicorp/vault NAME CHART VERSION APP VERSION DESCRIPTION hashicorp/vault 0.22.0 1.11.3 Official HashiCorp Vault Chart
Important: The Helm chart is new and under significant development.
Please always run Helm with
--dry-run before any install or upgrade to verify
Example chart usage:
Installing the latest release of the Vault Helm chart with pods prefixed with
$ helm install vault hashicorp/vault
Installing a specific version of the chart.
# List the available releases $ helm search repo hashicorp/vault -l NAME CHART VERSION APP VERSION DESCRIPTION hashicorp/vault 0.22.0 1.11.3 Official HashiCorp Vault Chart hashicorp/vault 0.21.0 1.11.2 Official HashiCorp Vault Chart hashicorp/vault 0.20.1 1.10.3 Official HashiCorp Vault Chart hashicorp/vault 0.20.0 1.10.3 Official HashiCorp Vault Chart hashicorp/vault 0.19.0 1.9.2 Official HashiCorp Vault Chart hashicorp/vault 0.18.0 1.9.0 Official HashiCorp Vault Chart hashicorp/vault 0.17.1 1.8.4 Official HashiCorp Vault Chart ... # Install version 0.22.0 $ helm install vault hashicorp/vault --version 0.22.0
Security Warning: By default, the chart runs in standalone mode. This mode uses a single Vault server with a file storage backend. This is a less secure and less resilient installation that is NOT appropriate for a production setup. It is highly recommended to use a properly secured Kubernetes cluster, learn the available configuration options, and read the production deployment checklist.
Refer to the Kubernetes tutorials series to learn how to run Vault on Kubernetes.