Install as a Rancher Apps & Marketplace

Run Longhorn on Kubernetes with Rancher 2.x

One benefit of installing Longhorn through Rancher Apps & Marketplace is that Rancher provides authentication to the Longhorn UI.

If there is a new version of Longhorn available, you will see an Upgrade Available sign on the Apps & Marketplace screen. You can click Upgrade button to upgrade Longhorn manager. See more about upgrade here.

Prerequisites

Each node in the Kubernetes cluster where Longhorn is installed must fulfill these requirements.

This script can be used to check the Longhorn environment for potential issues.

Installation

Note:

• For Kubernetes < v1.25, if your cluster still enables Pod Security Policy admission controller, set Other Settings > Pod Security Policy to true to install longhorn-psp PodSecurityPolicy resource which allows privileged Longhorn pods to start.

1. Optional: If Rancher version is 2.5.9 or before, we recommend creating a new project for Longhorn, for example, Storage.

2. Navigate to the cluster where you will install Longhorn.

   

3. Navigate to the Apps & Marketplace screen.

   

4. Find the Longhorn item in the charts and click it.

   

5. Click Install.

   

6. Optional: Select the project where you want to install Longhorn.

7. Optional: Customize the default settings.

   

8. Click Next. Longhorn will be installed in the longhorn-system namespace.

   

9. Click the Longhorn App Icon to navigate to the Longhorn dashboard.

   

After Longhorn has been successfully installed, you can access the Longhorn UI by navigating to the Longhorn option from Rancher left panel.