# Rancher Desktop — Kubernetes and Container Management on Your Desktop

> Rancher Desktop provides an easy way to run Kubernetes and manage containers on macOS, Windows, and Linux, offering a Docker Desktop alternative with built-in K3s.

## Install

Save as a script file and run:

# Rancher Desktop — Kubernetes and Container Management on Your Desktop

## Quick Use
```bash
# macOS install via Homebrew
brew install --cask rancher

# After launch, select your Kubernetes version in the UI
# Use kubectl as usual
kubectl get nodes
# Build containers with nerdctl (containerd) or dockerd
nerdctl build -t myapp .
```

## 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/

---
Source: https://tokrepo.com/en/workflows/48f2bb63-414b-11f1-9bc6-00163e2b0d79
Author: Script Depot