Rancher Desktop — Kubernetes and Container Management on Your Desktop

Introduction

Rancher Desktop is a free, open-source desktop application by SUSE that bundles Kubernetes (via K3s) and a container runtime into a single installer for macOS, Windows, and Linux. It provides a GUI for switching Kubernetes versions and choosing between containerd or dockerd as the container engine.

What Rancher Desktop Does

• Runs a local K3s Kubernetes cluster with selectable version from a dropdown
• Provides choice between containerd (with nerdctl CLI) or dockerd (with docker CLI)
• Includes a GUI dashboard for managing Kubernetes settings and container images
• Supports port forwarding, image building, and pushing from the desktop
• Integrates with kubectl, Helm, and other standard Kubernetes tooling

Architecture Overview

Rancher Desktop runs a Linux VM using Lima on macOS, WSL 2 on Windows, or QEMU on Linux. Inside the VM, K3s provides a lightweight certified Kubernetes distribution. The user selects containerd or dockerd as the container runtime. An Electron-based UI communicates with the VM over SSH/socket to manage the cluster lifecycle and settings.

Self-Hosting & Configuration

• Install via Homebrew Cask on macOS, winget or Chocolatey on Windows, or AppImage on Linux
• Select Kubernetes version and container runtime in the Preferences panel
• Configure resource allocation (CPU, memory) through the Virtual Machine settings
• Enable or disable Kubernetes entirely to use only the container engine
• Use rdctl CLI for headless configuration and automation in CI environments

Key Features

• One-click Kubernetes version switching without manual cluster teardown
• Choice between containerd and dockerd as the container runtime
• Built-in image management UI for listing, pulling, and deleting images
• Cross-platform support for macOS (Intel and Apple Silicon), Windows, and Linux
• Open source with no license fees or usage restrictions

Comparison with Similar Tools

• Docker Desktop — proprietary with license restrictions for large companies; Rancher Desktop is fully open source
• Minikube — CLI-based local K8s using various drivers; Rancher Desktop adds a GUI and integrated container engine selection
• kind — runs K8s clusters in Docker containers; Rancher Desktop provides a full VM-based environment with K3s
• Podman Desktop — focuses on rootless container management; Rancher Desktop adds built-in Kubernetes support
• Colima — CLI-only container runtime for macOS; Rancher Desktop provides a graphical interface and K8s management

FAQ

Q: Is Rancher Desktop a replacement for Docker Desktop? A: It can serve as a drop-in replacement. When configured with dockerd, it provides a docker CLI-compatible environment with no licensing restrictions.

Q: Can I run Rancher Desktop and Docker Desktop at the same time? A: Running both simultaneously is not recommended as they may conflict on port bindings and socket paths.

Q: Does Rancher Desktop support multi-node clusters? A: No. Rancher Desktop runs a single-node K3s cluster designed for local development. For multi-node setups, consider k3d or kind.

Q: How do I access services running in the cluster? A: Use kubectl port-forward, NodePort services, or the built-in port forwarding feature in the Rancher Desktop UI.

Sources

• https://github.com/rancher-sandbox/rancher-desktop
• https://docs.rancherdesktop.io/