Install as a Rancher Catalog App

Run Longhorn on Kubernetes with Rancher 2.x

Edit this page

One benefit of installing Longhorn through Rancher catalog 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 Catalog Apps page. 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

  1. Optional: We recommend creating a new project for Longhorn, for example, Storage.
  2. Navigate to the cluster and project where you will install Longhorn.
  3. Navigate to the Catalog Apps page.
  4. Find the Longhorn item in the catalog and click it.
  5. Optional: Customize the default settings.
  6. Click Launch. Longhorn will be installed in the longhorn-system namespace.
    Longhorn is now installed.
  7. Click the index.html link to navigate to the Longhorn dashboard.

After Longhorn has been successfully installed, you can access the Longhorn UI by navigating to the Catalog Apps page.

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


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