Skip to main content
Version: 0.7.1

Rancher Desktop configuration

This how-to was written using the following versions:

Rancher Desktop Prerequisites

  • Running on Windows requires Windows Subsystem for Linux (WSL) which is automatically installed by Rancher Desktop.
  • Epinio currently only supports x86 and will not work with Rancher Desktop for Mac on the M1 chip.

Install Rancher Desktop

Install the latest version of Rancher Desktop for your operating system.

Setup Kubernetes

When running Rancher Desktop for the first time, wait until the initialization is completed.

Make sure that Kubernetes is enabled and a supported version is selected under Kubernetes Settings (Epinio has been tested on v1.22.7, v1.21.10 and v1.20.15).

Make sure that Traefik is enabled or you have otherwise installed a Ingress controller.

Install epinio

Make sure Rancher Desktop is running.

Rancher Desktop can report Kubernetes as running while some pods are actually not yet ready. Manual verification is possible by executing the command kubectl get pods -A in a terminal and checking that all pods report either Running or Completed as their status.

Rancher Desktop configures it's own loadbalancer to expose Traefik on We can use this with a wildcard DNS to get a system domain of

The Epinio installation is pretty much identical on Linux, MacOS and Windows:

  1. Start a terminal, use cmd or powershell on Windows (latest one is preferred) and your preferred one on Linux/MacOS.

  2. Install the Epinio CLI.

  3. Follow the Epinio installation process. Copied here:

$ kubectl apply -f  

# Wait for cert-manager to stabilize

$ helm repo add epinio
$ helm install epinio -n epinio --create-namespace epinio/epinio --set

$ epinio settings update

NOTE: there is currently a blocking issue on Linux which prevent Epinio to push application! However, you will find a workaround at the end of the issue.