Rancher Desktop

Rancher Desktop est une application desktop open source développée par SUSE/Rancher, disponible sur macOS, Windows et Linux. Elle remplace Docker Desktop sans licence commerciale et embarque un cluster Kubernetes local via k3s, un runtime au choix (containerd avec nerdctl ou dockerd avec docker), ainsi que kubectl et Helm préinstallés. La version Kubernetes est sélectionnable depuis l'interface graphique. La CLI rdctl permet de tout configurer en ligne de commande.

Informations essentielles

Origine : SUSE / Rancher Labs  ·  Licence : Apache 2.0  ·  Architectures : x86_64, ARM64 (Apple Silicon)

Liens : Site officiel  ·  Documentation  ·  GitHub  ·  Releases

Support : SUSE/Rancher. Projet actif, releases régulières.

Stack par défaut

Prérequis

Installation

# macOS - Homebrew
brew install --cask rancher

# Linux - dépôt openSUSE
curl -s https://download.opensuse.org/repositories/isv:Rancher:stable/deb/Release.key \
  | gpg --dearmor \
  | sudo dd status=none of=/usr/share/keyrings/isv-rancher-stable-archive-keyring.gpg
echo 'deb [signed-by=/usr/share/keyrings/isv-rancher-stable-archive-keyring.gpg] https://download.opensuse.org/repositories/isv:/Rancher:/stable/deb/ ./' \
  | sudo tee /etc/apt/sources.list.d/isv-rancher-stable.list
sudo apt update && sudo apt install rancher-desktop

# Windows - Winget
winget install suse.RancherDesktop

Après installation, lancer l'application. Premier démarrage : téléchargement du runtime et de k3s (quelques minutes). Les binaires (kubectl, helm, nerdctl) sont ajoutés au PATH via ~/.rd/bin.

CLI rdctl

# Version
rdctl version

# Afficher les paramètres actuels
rdctl list-settings

# Changer le runtime (containerd ou moby)
rdctl set --container-engine.name=containerd
rdctl set --container-engine.name=moby

# Changer la version Kubernetes
rdctl set --kubernetes.version=v1.31.3

# Activer / désactiver Kubernetes
rdctl set --kubernetes.enabled=true
rdctl set --kubernetes.enabled=false

# Redémarrer Rancher Desktop
rdctl shutdown
# puis relancer depuis le menu ou rdctl start

Gestion des conteneurs et images

Avec containerd (nerdctl)

# nerdctl est compatible avec les commandes docker
nerdctl ps
nerdctl images
nerdctl run -d -p 8080:80 nginx
nerdctl build -t myimage:tag .
nerdctl push myimage:tag
nerdctl compose up -d      # Podman Compose ou compatible

Avec dockerd (moby)

docker ps
docker build -t myimage:tag .
docker compose up -d

Kubernetes

# kubectl et helm sont préinstallés, contexte configuré automatiquement
kubectl get nodes
kubectl config current-context   # rancher-desktop

helm version
helm repo add bitnami https://charts.bitnami.com/bitnami
helm install myrelease bitnami/postgresql

# Port-forward (Rancher Desktop route localhost → cluster)
kubectl port-forward svc/my-service 8080:80

Mise à jour

# macOS
brew upgrade --cask rancher

# Linux
sudo apt update && sudo apt upgrade rancher-desktop

# Windows
winget upgrade suse.RancherDesktop

Troubleshooting

# kubectl ne trouve pas le cluster
kubectl config use-context rancher-desktop

# nerdctl ou kubectl absents du PATH (Linux)
export PATH="$HOME/.rd/bin:$PATH"
echo 'export PATH="$HOME/.rd/bin:$PATH"' >> ~/.zshrc

# Conflit entre Docker et Rancher Desktop
rdctl set --container-engine.name=containerd
# puis redémarrer Rancher Desktop

# Réinitialiser (supprime cluster + données)
# Preferences > Troubleshooting > Factory Reset

# Logs
# macOS : ~/Library/Logs/Rancher Desktop/
# Linux : ~/.local/share/rancher-desktop/logs/
# Windows : %LOCALAPPDATA%\rancher-desktop\logs\

Ressources

• Site officiel : https://rancherdesktop.io
• Documentation : https://docs.rancherdesktop.io
• GitHub : https://github.com/rancher-sandbox/rancher-desktop
• Releases : https://github.com/rancher-sandbox/rancher-desktop/releases