New to KubeVault? Please start here.

Installation Guide

Vault CSI driver can be installed via a script or as a Helm chart.

Using Helm 3

Vault CSI driver can be installed via Helm using the chart from AppsCode Charts Repository. To install the chart with the release name csi-vault

$ helm repo add appscode https://charts.appscode.com/stable/
$ helm repo update
$ helm search repo appscode/csi-vault --version v0.3.0
NAME                CHART VERSION   APP VERSION DESCRIPTION
appscode/csi-vault  v0.3.0            v0.3.0        HashiCorp Vault CSI Driver for Kubernetes

# Kubernetes 1.14+ (CSI driver spec 1.0.0)
$ helm install csi-vault appscode/csi-vault \
  --version v0.3.0 \
  --namespace kube-system

To see the detailed configuration options, visit here.

Using Helm 2

Vault CSI driver can be installed via Helm using the chart from AppsCode Charts Repository. To install the chart with the release name csi-vault

$ helm repo add appscode https://charts.appscode.com/stable/
$ helm repo update
$ helm search appscode/csi-vault --version v0.3.0
NAME              	CHART VERSION	APP VERSION	DESCRIPTION
appscode/csi-vault	v0.3.0        	v0.3.0      	HashiCorp Vault CSI Driver for Kubernetes

# Kubernetes 1.14+ (CSI driver spec 1.0.0)
$ helm install appscode/csi-vault --name csi-vault \
  --version v0.3.0 \
  --namespace kube-system

To see the detailed configuration options, visit here.

Using YAML

If you prefer to not use Helm, you can generate YAMLs from Vault CSI driver chart and deploy using kubectl. Here we are going to show the prodecure using Helm 3.

$ helm repo add appscode https://charts.appscode.com/stable/
$ helm repo update
$ helm search repo appscode/csi-vault --version v0.3.0
NAME                CHART VERSION   APP VERSION DESCRIPTION
appscode/csi-vault  v0.3.0            v0.3.0        HashiCorp Vault CSI Driver for Kubernetes

# Kubernetes 1.14+ (CSI driver spec 1.0.0)
$ helm template csi-vault appscode/csi-vault \
  --version v0.3.0 \
  --namespace kube-system \
  --no-hooks | kubectl apply -f -

To see the detailed configuration options, visit here.

Verify Installation

To check if Vault CSI driver installed successfully, run the following command:

$ kubectl get csinodeinfos
NAME              AGE
2gb-pool-77jne6   31s

If you can see the node’s list, then your installation is ok.