The following document pertains to running Longhorn from the Rancher 2.0 chart.

Source Code

Longhorn is 100% 完全开源 software. Project source code is spread across a number of repos:

  1. Longhorn Engine -- Core controller/replica logic
  2. Longhorn Manager -- Longhorn orchestration, includes Flexvolume driver for Kubernetes
  3. Longhorn UI -- Dashboard


  1. Rancher v2.1+
  2. Docker v1.13+
  3. Kubernetes v1.8+ cluster with 1 or more nodes and Mount Propagation feature enabled. If your Kubernetes cluster was provisioned by Rancher v2.0.7+ or later, MountPropagation feature is enabled by default. Check your Kubernetes environment now. If MountPropagation is disabled, the Kubernetes Flexvolume driver will be deployed instead of the default CSI driver. Base Image feature will also be disabled if MountPropagation is disabled.
  4. Make sure curl, findmnt, grep, awk and blkid has been installed in all nodes of the Kubernetes cluster.
  5. Make sure open-iscsi has been installed in all nodes of the Kubernetes cluster. For GKE, recommended Ubuntu as guest OS image since it contains open-iscsi already.


  1. To prevent damage to the Kubernetes cluster, we recommend deleting all Kubernetes workloads using Longhorn volumes (PersistentVolume, PersistentVolumeClaim, StorageClass, Deployment, StatefulSet, DaemonSet, etc).

  2. From Rancher UI, navigate to Catalog Apps tab and delete Longhorn app.


I deleted the Longhorn App from Rancher UI instead of following the uninstallation procedure

Redeploy the (same version) Longhorn App. Follow the uninstallation procedure above.

Problems with CRDs

If your CRD instances or the CRDs themselves can't be deleted for whatever reason, run the commands below to clean up. Caution: this will wipe all Longhorn state!

# Delete CRD finalizers, instances and definitions
for crd in $(kubectl --kubeconfig=kube_configxxx.yml  get  crd -o jsonpath={.items[*]} | tr ' ' '\n' | grep; do
  kubectl --kubeconfig=kube_configxxx.yml -n   ${NAMESPACE} get $crd -o yaml | sed "s/\-" | kubectl --kubeconfig=kube_configxxx.yml  apply  -f -
  kubectl --kubeconfig=kube_configxxx.yml -n   ${NAMESPACE} delete $crd --all
  kubectl --kubeconfig=kube_configxxx.yml delete  crd/$crd

Volume can be attached/detached from UI, but Kubernetes Pod/StatefulSet etc cannot use it

Check if volume plugin directory has been set correctly. This is automatically detected unless user explicitly set it.

By default, Kubernetes uses /usr/libexec/kubernetes/kubelet-plugins/volume/exec/, as stated in the official document.

Some vendors choose to change the directory for various reasons. For example, GKE uses /home/kubernetes/flexvolume instead.

User can find the correct directory by running ps aux|grep kubelet on the host and check the --volume-plugin-dir parameter. If there is none, the default /usr/libexec/kubernetes/kubelet-plugins/volume/exec/ will be used.

Please see link for more information.