selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Rancher logo

Self-host Rancher

v2.15.3

Open-source multi-cluster Kubernetes management platform

ReleaseOpen SourceApache-2.0
Updated2 weeks ago
LanguageGo
Setup difficultyAdvanced
Stars
26 058
RAM
4GB
Ports
80 (Rancher UI/API when a load balancer or proxy does external SSL termination), 443 (Rancher UI/API, agent and kubectl traffic (mapped 80:80 and 443:443 in the Docker install))
Requires
Kubernetes
Docker
rancher/rancher
Install with Docker
Rancher UI sign-in screen used while configuring an external auth providerUsers page of the Rancher UI showing principal accounts

What is Rancher?

Rancher alternatives

Should you self-host Rancher?

Rancher scores 76/100 on selfhost.directory (how scoring works) and ranks #1 of 7 in Kubernetes. It has 26 058 GitHub stars, +82 in the last 30 days.

It shipped 24 stable releases in the past year. The latest, v2.15.3, came out on 29 October 2026.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is Meshery (74/100, 12 210 stars). Rancher scores higher overall. See Rancher vs Meshery side by side.

Features

  • Application catalog (Helm)
  • Bootstrap password and admin recovery tooling
  • Centralized AuthenticationLocal authentication is provided as a built-in default intended for small or test setups.
  • Cluster provisioning and import
  • External CI/CD integration
  • GitOps workload deployment with Fleet
  • High-availability installs
  • Log Forwarding
  • Monitoring and Alerting
  • REST API
  • Role-based Access Control

Rancher README

Rancher

Docker Pulls

Rancher is an open source container management platform built for organizations that deploy containers in production. Rancher makes it easy to run Kubernetes everywhere, meet IT requirements, and empower DevOps teams.

How to install Rancher

Install Rancher with Docker

sudo docker run -d --restart=unless-stopped -p 80:80 -p 443:443 --privileged rancher/rancher

Open your browser to https://localhost

Single-node evaluation install; the container also stores Rancher's state in its embedded etcd under /var/lib/rancher.

How to configure Rancher

  • bootstrapPassword" "string - Set the bootstrap password for the first admin user. After logging in, the admin should reset their password. A randomly generated bootstrap password is used if this value is not set.
  • hostname" "string - the Fully Qualified Domain Name for your Rancher Server
  • ingress.tls.source"rancher"string - Where to get the cert for the ingress. - "rancher, letsEncrypt, secret"
  • letsEncrypt.email" "string - Your email address
  • letsEncrypt.environment"production"string - Valid options: "staging, production"

Rancher releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

How can I automate task X in Rancher?

Because the UI only calls the API, browse the API at https://your_rancher_ip/v3 or capture the UI's API calls and script them.

How can I access nodes created by Rancher?

Download the node's SSH keys from the Nodes view using the row menu, then connect with the id_rsa file and the correct username.

How are the supported Docker versions determined?

Rancher follows the Docker versions validated by upstream Kubernetes, listed under External Dependencies in the Kubernetes release changelogs.

Where is the state of Rancher stored?

With the Docker install it lives in the container's embedded etcd under /var/lib/rancher; with a Kubernetes install it is stored in the RKE2 or K3s cluster running Rancher.

Why is my Layer-4 Load Balancer in Pending state?

Layer-4 load balancers are created as type: LoadBalancer, which stays pending unless a cloud provider or controller in the cluster can satisfy such requests.

Where can I manage Node Templates?

Open the account menu in the top right of the UI and select Node Templates.

My ClusterIP does not respond to ping

A ClusterIP is a virtual address and never answers ICMP, so test it with curl against the IP and port instead.

How can I enable debug logging?

The FAQ points to the troubleshooting documentation's logging section for enabling debug logging.

I deleted/deactivated the last admin, how can I fix it?

Use the ensure-default-admin command in the Rancher container or pod to create a new default administrator and print its password.

How can I reset the administrator password?

Run the reset-password command inside the Rancher container (Docker install) or inside the rancher pod in the cattle-system namespace (Helm install), which prints a new password for the default administrator.

More in Kubernetes

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…