The Longhorn Documentation

Cloud native distributed block storage for Kubernetes

Longhorn is a lightweight, reliable, and powerful distributed block storage system for Kubernetes.

Longhorn implements distributed block storage using containers and microservices. Longhorn creates a dedicated storage controller for each block device volume and synchronously replicates the volume across multiple replicas stored on multiple nodes. The storage controller and replicas are themselves orchestrated using Kubernetes.


  • Enterprise-grade distributed block storage with no single point of failure
  • Incremental snapshot of block storage
  • Backup to secondary storage (NFS or S3-compatible object storage) built on efficient change block detection
  • Recurring snapshot and backup
  • Automated, non-disruptive upgrades. You can upgrade the entire Longhorn software stack without disrupting running storage volumes.]
  • An intuitive GUI dashboard

Current status

Longhorn is beta-quality software. We appreciate your willingness to deploy Longhorn and provide feedback.

The latest release of Longhorn is v0.8.0.

Source code

Longhorn is 100% open source software under the auspices of the Cloud Native Computing Foundation. The project’s source code is spread across a number of repos:

ComponentWhat it doesGitHub repo
Longhorn EngineCore controller/replica logiclonghorn/longhorn-engine
Longhorn Instance ManagerController/replica instance lifecycle managementlonghorn/longhorn-instance-manager
Longhorn Share ManagerNFS provisioner that exposes Longhorn volumes as ReadWriteMany volumeslonghorn/longhorn-share-manager
Longhorn ManagerLonghorn orchestration, includes CSI driver for Kuberneteslonghorn/longhorn-manager
Longhorn UIThe Longhorn dashboardlonghorn/longhorn-ui

© 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.