# Rancher Desktop

Local container and Kubernetes development environment with a Linux VM, containerd or Docker-compatible Moby engine, and desktop management tools.

> This is the Markdown version of the Rancher Desktop page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/rancher>

- **Latest version**: `1.25.0`
- **Developer**: SUSE / Rancher Desktop contributors
- **Homepage**: <https://rancherdesktop.io/>
- **Categories**: [Virtualization & Containers](https://opennavo.com/categories/virtualization)
- **Install**: `brew install --cask rancher`
- **30-day installs**: 1,820
- **Homebrew**: Available; the app updates itself
- **Download URL**: <https://github.com/rancher-sandbox/rancher-desktop/releases/download/v1.25.0/Rancher.Desktop-1.25.0.aarch64.dmg>
- **SHA-256**: `17b93863838fc3860d4adb0fa58a76a283011c3ea8743205b306e23f5282c671`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "delete": [
            "/opt/rancher-desktop",
            "/private/etc/sudoers.d/zzzzz-rancher-desktop-lima",
            "/private/var/run/docker.sock",
            "/private/var/run/rancher-desktop-*"
          ],
          "quit": "io.rancherdesktop.app"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "app": [
        "Rancher Desktop.app"
      ],
      "target": "/Applications/Rancher Desktop.app"
    },
    "phase": "install",
    "sources": [
      "Rancher Desktop.app"
    ],
    "target": "/Applications/Rancher Desktop.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/.kuberlr",
            "~/.rd",
            "~/Library/Application Support/Caches/rancher-desktop-updater",
            "~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/io.rancherdesktop.app.sfl*",
            "~/Library/Application Support/Rancher Desktop",
            "~/Library/Application Support/rancher-desktop",
            "~/Library/Caches/io.rancherdesktop.app*",
            "~/Library/Caches/rancher-desktop",
            "~/Library/Logs/rancher-desktop",
            "~/Library/Preferences/ByHost/io.rancherdesktop.app*",
            "~/Library/Preferences/io.rancherdesktop.app.plist",
            "~/Library/Preferences/rancher-desktop",
            "~/Library/Saved Application State/io.rancherdesktop.app.savedState"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

Rancher Desktop is an open-source desktop environment for building and running containers and a local Kubernetes cluster. On macOS it runs the Linux container environment inside a virtual machine. It provides a container dashboard, image management, Kubernetes settings, port forwarding and bundled command-line tools including kubectl, Helm, nerdctl and Docker-compatible tools. It is intended for local development and testing, not a managed production Kubernetes service.

### Container engines and Kubernetes
Choose one container engine at a time. containerd uses nerdctl and container namespaces; dockerd (Moby) provides the Docker Engine API and Docker CLI workflow. Docker Desktop is not required. Images and workloads created under one engine are not available after switching to the other engine; engine selection is not a migration of their storage.

Kubernetes is optional and can be enabled or disabled separately. When enabled, Rancher Desktop manages a local K3s-based cluster and its version, exposing it through kubectl and the Cluster Dashboard. Select the intended Kubernetes context before applying manifests so commands do not target a different cluster. Published ports and mounted host directories give workloads access outside the VM according to your configuration.

### Installation and resources
Rancher Desktop requires macOS 13 Ventura or later, an Apple Silicon or Intel x86-64 processor with virtualization support, and a persistent internet connection. The documentation recommends at least 8 GB RAM and four CPUs; workloads may need more memory, CPU and disk space. Downloads are architecture-specific: the 1.24.0 Apple Silicon DMG is 648,410,732 bytes and the Intel DMG is 701,015,407 bytes, before VM images and container data.

Copy the application from its DMG to Applications and open it. Choose the engine and Kubernetes settings, allocate VM resources, and let the environment initialize and download required components. Registry downloads and private registries can require internet access and their own credentials. Rancher Desktop itself is free and does not require a paid Rancher or Docker Desktop subscription to run locally.

### Permissions and coexistence
Administrative Access is optional for many workflows. Without it, the Docker socket is at ~/.rd/docker.sock and Docker tools use the rancher-desktop context. Enabling it creates /var/run/docker.sock and enables a bridged address reachable from the local network, prompting for administrator credentials. The vmnet bridged-network path also uses macOS mDNSResponder on port 53, preventing forwarding a container DNS server to host port 53 in that configuration.

Docker Desktop and other local container tools can compete for the default Docker socket, CLI context, published ports and substantial VM resources. Stop the competing environment when necessary and explicitly check the active Docker and Kubernetes contexts. Rancher Desktop does not merge the other tool's images, volumes or containers. Treat container engines and extensions as powerful local software: containers with host-directory mounts can change those files, and published services can expose data. Factory resets and environment deletion can remove local containers, images and cluster data, so preserve important data first.

### License and updates
The application is licensed under Apache License 2.0; bundled tools and images retain their own licenses. Registries, cloud services and optional external services can have separate charges or account requirements. Anonymous usage-statistics collection is controlled in Preferences, as are automatic updates.

The 1.24.0 release fixes an auto-update failure in 1.23.0 and 1.23.1. Users on those versions who cannot download the update through the app need the official installer. The separately announced Rancher Desktop 2.0 alpha is an early technology preview, not this 1.24.0 package or a production-ready replacement.

Official sources: [Project](https://rancherdesktop.io/), [Installation requirements](https://docs.rancherdesktop.io/getting-started/installation/), [Container engines](https://docs.rancherdesktop.io/ui/preferences/container-engine/general/), [Administrative access and preferences](https://docs.rancherdesktop.io/ui/preferences/application/general/), [Source and license](https://github.com/rancher-sandbox/rancher-desktop), [1.24.0 release](https://github.com/rancher-sandbox/rancher-desktop/releases/tag/v1.24.0).

## System requirements

- macOS 13 or later · Version: 1.25.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · Checked 2026-11-22
  - <https://github.com/rancher-sandbox/rancher-desktop/releases/download/v1.25.0/Rancher.Desktop-1.25.0.x86_64.dmg>
  - SHA-256: `859c6384ac33e8c1ddc0f37eb8e0ed26cdd977d6ac0a58b9235e7a2a4c33080b`
- macOS 13 or later · Version: 1.25.0 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · Checked 2026-11-22
  - <https://github.com/rancher-sandbox/rancher-desktop/releases/download/v1.25.0/Rancher.Desktop-1.25.0.aarch64.dmg>
  - SHA-256: `17b93863838fc3860d4adb0fa58a76a283011c3ea8743205b306e23f5282c671`

## Rancher Desktop security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/rancher-sandbox/rancher-desktop> · Open source: Yes — <https://github.com/rancher-sandbox/rancher-desktop> · Checked 2026-11-13

## Uninstall

- `brew uninstall --cask rancher`

A regular uninstall removes the app and keeps its settings and caches.

### Uninstalling also removes

- Files and folders: `/opt/rancher-desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `/private/etc/sudoers.d/zzzzz-rancher-desktop-lima` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `/private/var/run/docker.sock` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `/private/var/run/rancher-desktop-*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

### Deep clean (optional)

- `brew uninstall --zap --cask rancher`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/.kuberlr` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/.rd` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/Caches/rancher-desktop-updater` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/io.rancherdesktop.app.sfl*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/Rancher Desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/rancher-desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Caches/io.rancherdesktop.app*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Caches/rancher-desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Logs/rancher-desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/ByHost/io.rancherdesktop.app*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/io.rancherdesktop.app.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/rancher-desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Saved Application State/io.rancherdesktop.app.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 1.25.0 (2026-11-05)

Vietnamese UI, delete confirmation, and fixes for root via networks.yaml.

Rancher Desktop 1.25.0 was released on 2026-11-05. This update adds a Vietnamese interface, asks before deleting containers and volumes, and closes a macOS path to root through networks.yaml.

- Adds Vietnamese under Preferences > Application > General. It is experimental, like the eight languages added in 1.24.0. Vietnamese text uses a font installed on the system, because the app's usual font lacks most accented letters.
- Delete on the Containers and Volumes pages now asks first. The dialog counts the containers or volumes and lists them by name. Cancel is the default button, so Esc and Enter both back out.
- Tables on Containers, Volumes, Forwarding, and Diagnostics can show up to 1000 rows per page. Containers and Volumes previously showed 10. Forwarding and Diagnostics showed 100.
- On macOS, a process running as you could get root through the admin-access prompt. Rancher Desktop copied values from Lima's networks.yaml, which your user account can edit, into the sudoers file it installs as root. It now renames a networks.yaml whose addresses are not all IPv4 to networks.orig.yaml and uses its default networks instead, and it refuses shell syntax in paths passed to commands run as root.
- Stops trusting eight eMudhra intermediate certificate authorities whose private keys can be recovered from the certificates. 1.24.0 accepted TLS certificates they could issue, in the app and inside the virtual machine. 1.25.0 no longer trusts them in the app, in host CA certificates copied into the virtual machine, in the virtual machine image or the WSL distribution, in its Go programs, or in Spin apps.
- On macOS, with the VZ virtual machine type and Kubernetes enabled, outbound connections failed for about a minute after each Kubernetes start. The bundled Lima now allows 128 connections in progress and gives up on each after 30 seconds.
- Pods on macOS and Linux no longer inherit the host's DNS search domains. A pod that needs one can set dnsConfig.searches.
- Turning off Traefik now deletes only the Traefik Helm chart. The definitions chart is left to k3s. On a slow machine, k3s can still remove that chart before Traefik is gone.
- Update checks work after a factory reset even when Kubernetes is disabled.
- Multi-select on the Containers page works again, including Shift-click and Cmd-click on macOS. A leading slash before container names is gone. The Standalone Containers label is translated.
- Settings validation rejects a port such as 6443oops, a CPU count of 2.5, and null or a list in place of a group of settings.
- The Extensions catalog provides the Docker Desktop extension theme and offers Tachometer 0.2.6.
- Known issue: with Rancher Desktop already running, rdctl start --wait without a setting flag fails with "start command: no settings to change were given". A setting that needs a restart can return before the restart begins while the backend is still starting.
- Rancher Desktop 1.26 will drop Kubernetes versions older than 1.32. 1.25 still lets you go back. A deployment profile that locks an older version will keep Kubernetes from starting on 1.26 until the profile changes.
- Bundled utilities from 1.24.0: docker 29.6.2 to 29.9.3, docker-compose 5.3.1 to 5.7.0, docker-buildx 0.35.0 to 0.38.2, docker-credential-helpers 0.9.8 to 0.9.12, helm 4.2.3 to 4.3.1, kuberlr 0.7.0 to 0.9.0, trivy 0.72.0 to 0.76.1, spin 4.0.2 to 4.2.6, spin-shim 0.25.1 to 0.27.2, cert-manager 1.21.0 to 1.21.3. nerdctl stays 2.2.2.

Windows-only notes are omitted here. The full list is in the GitHub release.

Source: https://github.com/rancher-sandbox/rancher-desktop/releases/tag/v1.25.0

## Facts and sources

- <https://opennavo.com/apps/rancher>
- <https://opennavo.com/apps/rancher/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/r/rancher.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/rancher>
- <https://github.com/rancher-sandbox/rancher-desktop> · Checked 2026-11-13
