Longhorn CSI on K3s


  • Kubernetes v1.11 or higher.
  • Longhorn v0.4.1 or higher.
  • open-iscsi or iscsiadm installed on the node.



1. For Longhorn v0.7.0 and above

Longhorn v0.7.0 and above support k3s v0.10.0 and above only by default.

If you want to deploy these new Longhorn versions on versions before k3s v0.10.0, you need to set --kubelet-root-dir to <data-dir>/agent/kubelet for the Deployment longhorn-driver-deployer in longhorn/deploy/longhorn.yaml. data-dir is a k3s arg and it can be set when you launch a k3s server. By default it is /var/lib/rancher/k3s.

2. For Longhorn before v0.7.0

Longhorn versions before v0.7.0 support k3s below v0.10.0 only by default.

If you want to deploy these older Longhorn versions on k3s v0.10.0 and above, you need to set --kubelet-root-dir to /var/lib/kubelet for the Deployment longhorn-driver-deployer in longhorn/deploy/longhorn.yaml


Common issues

This error is due to Longhorn cannot detect where is the root dir setup for Kubelet, so the CSI plugin installation failed.

You can override the root-dir detection by setting argument kubelet-root-dir in https://github.com/longhorn/longhorn/blob/v0.8.0/deploy/longhorn.yaml.

How to find root-dir?

Run ps aux | grep k3s and get argument --data-dir or -d on k3s node.


$ ps uax | grep k3s
root      4160  0.0  0.0  51420  3948 pts/0    S+   00:55   0:00 sudo /usr/local/bin/k3s server --data-dir /opt/test/kubelet
root      4161 49.0  4.0 259204 164292 pts/0   Sl+  00:55   0:04 /usr/local/bin/k3s server --data-dir /opt/test/kubelet

You will find data-dir in the cmdline of proc k3s. By default it is not set and /var/lib/rancher/k3s will be used. Then joining data-dir with /agent/kubelet you will get the root-dir. So the default root-dir for K3S is /var/lib/rancher/k3s/agent/kubelet.

If K3S is using a configuration file, you would need to check the configuration file to locate the data-dir parameter.

For K3S v0.10.0+

It is always /var/lib/kubelet


Longhorn versions before v0.7.0 don’t work on K3S v0.10.0 or above

K3S now sets its kubelet directory to /var/lib/kubelet. See the K3S release comment for details.



© 2019-2024 Longhorn Authors | Documentation Distributed under CC-BY-4.0

© 2024 The Linux Foundation. All rights reserved. The Linux Foundation has registered trademarks and uses trademarks. For a list of trademarks of The Linux Foundation, please see our Trademark Usage page.