Awesome

<h1 align="center" style="border-bottom: none"> <a href="https://longhorn.io/" target="_blank"><img alt="Longhorn" width="300px" src="https://github.com/longhorn/website/blob/master/static/img/logos/longhorn-stacked-color.png""></a> </h1> <p align="center">A CNCF Incubating Project. Visit <a href="https://longhorn.io/" target="_blank">longhorn.io</a> for the full documentation.</p> <div align="center">

</div>

Longhorn is a distributed block storage system for Kubernetes. Longhorn is cloud-native storage built using Kubernetes and container primitives.

Longhorn is lightweight, reliable, and powerful. You can install Longhorn on an existing Kubernetes cluster with one kubectl apply command or by using Helm charts. Once Longhorn is installed, it adds persistent volume support to the Kubernetes cluster.

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. Here are some notable features of Longhorn:

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

You can read more technical details of Longhorn here.

Releases

NOTE:

<version>* means the release branch is under active support and will have periodic follow-up patch releases.

Latest release means the version is the latest release of the newest release branch.

Stable release means the version is stable and has been widely adopted by users.

Release EOL: One year after the first stable version. For the details, please refer to Release Support.

https://github.com/longhorn/longhorn/releases

Release	Latest Version	Stable Versions	Release Note	Important Note	Active
1.7*	1.7.2	1.7.2, 1.7.1	🔗	🔗	✅
1.6*	1.6.3	1.6.3, 1.6.2, 1.6.1	🔗	🔗	✅
1.5*	1.5.5	1.5.5, 1.5.4, 1.5.3	🔗	🔗	✅
1.4	1.4.4	1.4.4, 1.4.3, 1.4.2, 1.4.1	🔗	🔗
1.3	1.3.3	1.3.3, 1.3.2	🔗	🔗
1.2	1.2.6	1.2.6, 1.2.5, 1.2.4, 1.2.3, 1.2.2	🔗	🔗
1.1	1.1.3	1.1.3, 1.1.2	🔗

Roadmap

https://github.com/longhorn/longhorn/wiki/Roadmap

Components

Longhorn is 100% open-source software. Project source code is spread across several repositories:

Manager:
Instance Manager:
Engine:
Share Manager:
Backing Image Manager:
UI:

Component	What it does	GitHub repo
Longhorn Backing Image Manager	Backing image download, sync, and deletion in a disk	longhorn/backing-image-manager
Longhorn Instance Manager	Controller/replica instance lifecycle management	longhorn/longhorn-instance-manager
Longhorn Manager	Longhorn orchestration, includes CSI driver for Kubernetes	longhorn/longhorn-manager
Longhorn Share Manager	NFS provisioner that exposes Longhorn volumes as ReadWriteMany volumes	longhorn/longhorn-share-manager
Longhorn UI	The Longhorn dashboard	longhorn/longhorn-ui

Library	What it does	GitHub repo
Longhorn Engine	V1 Core controller/replica logic	longhorn/longhorn-engine
Longhorn SPDK Engine	V2 Core controller/replica logic	longhorn/longhorn-spdk-engine
iSCSI Helper	V1 iSCSI client and server libraries	longhorn/go-iscsi-helper
SPDK Helper	V2 SPDK client and server libraries	longhorn/go-spdk-helper
Backup Store	Backkup libraries	longhorn/backupstore
Common Libraries		longhorn/go-common-libs

Longhorn UI

Get Started

Requirements

For the installation requirements, refer to the Longhorn documentation.

Installation

NOTE: Please note that the master branch is for the upcoming feature release development. For an official release installation or upgrade, please take a look at the ways below.

Longhorn can be installed on a Kubernetes cluster in several ways:

Documentation

The official Longhorn documentation is here.

Get Involved

Discussion, Feedback

If having any discussions or feedback, feel free to file a discussion.

Features Request, Bug Reporting

If having any issues, feel free to file an issue. We have a weekly community issue review meeting to review all reported issues or enhancement requests.

When creating a bug issue, please help upload the support bundle to the issue or send it to longhorn-support-bundle.

Report Vulnerabilities

If any vulnerabilities are found, please report them to longhorn-security.

Community

Longhorn is open-source software, so contributions are greatly welcome. Please read Code of Conduct and Contributing Guideline before contributing.

Contributing code is not the only way of contributing. We value feedback very much and many of the Longhorn features originated from users' feedback. If you have any feedback, feel free to file an issue and talk to the developers at the CNCF #longhorn Slack channel.

If you are having any discussion, feedback, requests, issues, or security reports, please follow the below ways. We also have a CNCF Slack channel: longhorn for discussion.

Community Meeting and Office Hours

Hosted by the core maintainers of Longhorn: 4th Friday of every month at 09:00 (CET) or 16:00 (CST) at https://community.cncf.io/longhorn-community/.

Longhorn Mailing List

Stay up to date on the latest news and events: https://lists.cncf.io/g/cncf-longhorn

You can read more about the community and its events here: https://github.com/longhorn/community

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.