In this section, you will learn how to install Longhorn with Helm.
- Each node in the Kubernetes cluster where Longhorn will be installed must fulfill
- Helm v2.0+ must be installed on your workstation.
- Refer to the official documentation for help installing Helm.
- If you’re using a Helm version prior to version 3.0, you need to install Tiller in your Kubernetes cluster with role-based access control (RBAC).
Installing Longhorn
Note:
- The initial settings for Longhorn can be found in customized using Helm options or by editing the deployment configuration file.
- For Kubernetes < v1.25, if your cluster still enables Pod Security Policy admission controller, set the helm value to
true
to installlonghorn-psp
PodSecurityPolicy resource which allows privileged Longhorn pods to start.
Fetch the latest charts from the repository:
helm repo update
Install Longhorn in the
longhorn-system
namespace.To install Longhorn with Helm 2, use the command:
To confirm that the deployment succeeded, run:
The result should look like the following:
NAME READY STATUS RESTARTS AGE
longhorn-ui-b7c844b49-w25g5 1/1 Running 0 2m41s
longhorn-conversion-webhook-5dc58756b6-9d5w7 1/1 Running 0 2m41s
longhorn-conversion-webhook-5dc58756b6-jp5fw 1/1 Running 0 2m41s
longhorn-admission-webhook-8b7f74576-pbxsv 1/1 Running 0 2m41s
longhorn-manager-pzgsp 1/1 Running 0 2m41s
longhorn-driver-deployer-6bd59c9f76-lqczw 1/1 Running 0 2m41s
longhorn-csi-plugin-mbwqz 2/2 Running 0 100s
csi-snapshotter-588457fcdf-22bqp 1/1 Running 0 100s
csi-snapshotter-588457fcdf-2wd6g 1/1 Running 0 100s
csi-provisioner-869bdc4b79-mzrwf 1/1 Running 0 101s
csi-resizer-6d8cf5f99f-fd2ck 1/1 Running 0 101s
csi-snapshotter-588457fcdf-bvjdt 1/1 Running 0 100s
csi-resizer-6d8cf5f99f-68cw7 1/1 Running 0 101s
csi-attacher-7bf4b7f996-df8v6 1/1 Running 0 101s
csi-attacher-7bf4b7f996-g9cwc 1/1 Running 0 101s
csi-attacher-7bf4b7f996-8l9sw 1/1 Running 0 101s
csi-resizer-6d8cf5f99f-smdjw 1/1 Running 0 101s
instance-manager-r-371b1b2e 1/1 Running 0 114s
instance-manager-e-7c5ac28d 1/1 Running 0 114s
engine-image-ei-df38d2e5-cv6nc 1/1 Running 0 114s
To enable access to the Longhorn UI, you will need to set up an Ingress controller. Authentication to the Longhorn UI is not enabled by default. For information on creating an NGINX Ingress controller with basic authentication, refer to