Skip to main content
Version: v1.0 (EOL)

Rancher Integration

Available as of v0.3.0

Rancher is an open-source multi-cluster management platform. Harvester has integrated Rancher by default starting with Rancher v2.6.1.

Rancher & Harvester Support Matrix

For the support matrix, please see Harvester & Rancher Support Matrix.


Harvester v1.0.0 is compatible with Rancher v2.6.3 or above only.

Users can now import and manage multiple Harvester clusters using the Rancher Virtualization Management page and leverage the Rancher authentication feature and RBAC control for multi-tenancy support.


Deploying Rancher Server

To use Rancher with Harvester, please install the Rancher and Harvester in two separated servers. If you want to try out the integration features, you can create a VM in Harvester and install Rancher v2.6.3 or above (the latest stable version is recommended).

Use one of the following guides to deploy and provision Rancher and a Kubernetes cluster with the provider of your choice:


Do not install Rancher with Docker in production. Otherwise, your environment may be damaged and your cluster may not be recovered. Installing Rancher in Docker should only be used for quick evaluation and testing purposes.

To install Rancher with Docker:

  1. Begin creation of a custom cluster by provisioning a Linux host. Your host can be any of the following:
    • A cloud-hosted virtual machine (VM)
    • An on-premises VM
    • A bare-metal server
  2. Log into your Linux host using your preferred shell, such as PuTTy or a remote terminal connection.
  3. From your shell, enter the following command:
# for a quick evaluation, you can run the Rancher server with the following command
$ sudo docker run -d --restart=unless-stopped -p 80:80 -p 443:443 --privileged rancher/rancher:v2.6.6

Virtualization Management

With Rancher's Virtualization Management feature, you can now import and manage Harvester clusters. By clicking on one of the clusters, you are able to view and manage the imported Harvester cluster resources like Hosts, VMs, images, volumes, etc. Additionally, the Virtualization Management leverages existing Rancher features such as authentication with various auth providers and multi-tenant support.

For more details, please check the virtualization management page.


Creating Kubernetes Clusters using the Harvester Node Driver

Harvester node driver is used to provision VMs in the Harvester cluster, which Rancher uses to launch and manage guest Kubernetes clusters.

Starting with Rancher v2.6.1, the Harvester node driver has been added by default. Users can reference the node-driver page for more details.