Rancher Desktop 완전 가이드 — K3s가 내장된 오픈소스 데스크톱 도구 ⋆ Blog * JackerLab

Docker Desktop에 라이선스 부담이 있고, Colima는 GUI가 없어 아쉽다면, 그 사이에 정확히 자리 잡은 도구가 있습니다. Rancher Desktop입니다.

이름에서 알 수 있듯 SUSE의 Rancher 팀이 만든 도구로, 완전 무료 오픈소스, 모든 주요 OS 지원, Kubernetes(K3s) 기본 내장이라는 세 가지 강점을 한 패키지에 담았습니다. Docker Desktop의 라이선스를 피하면서도 GUI를 포기하고 싶지 않은 사용자, 그리고 로컬에서 Kubernetes를 자주 다루는 개발자들이 자연스럽게 모이는 도구입니다.

이 가이드도 macOS(Apple Silicon)를 기준으로 작성되었습니다.

1. Rancher Desktop 소개

Rancher Desktop은 Rancher Labs(현재 SUSE) 가 만든 오픈소스 데스크톱 컨테이너 플랫폼입니다. 2021년 첫 공개되었고, 비교적 최근에 나온 도구이지만 빠르게 안정화되었습니다.

가장 큰 특징은 Kubernetes(K3s)가 처음부터 내장되어 있다는 점입니다. Docker Desktop도 Kubernetes 기능을 제공하지만, Rancher Desktop은 “컨테이너 + Kubernetes 통합 환경”을 본격적으로 표방합니다. K3s는 Rancher가 만든 경량 Kubernetes 배포판이라, 같은 회사의 도구끼리 자연스럽게 통합됩니다.

또 하나 독특한 점은 컨테이너 런타임을 선택할 수 있다는 것입니다.

dockerd (moby): 표준 Docker 호환 런타임, docker CLI 사용
containerd: Kubernetes 표준 런타임, nerdctl CLI 사용

용도에 따라 토글로 전환 가능합니다.

탄생 배경

Rancher는 원래 Kubernetes 관리 플랫폼으로 유명한 회사입니다. 자사 제품인 Rancher(K8s 관리 도구), K3s(경량 K8s)와 자연스럽게 어울리는 데스크톱 도구가 필요했습니다. 그래서 Rancher Desktop이 탄생했고, “개발자가 로컬에서 K8s까지 손쉽게 다룰 수 있는 환경“이라는 정체성을 갖게 되었습니다.

2. 특징과 강점/약점

강점

완전 무료 오픈소스 (Apache 2.0 라이선스), 상업적 사용 제한 없음
모든 주요 OS 지원 — macOS, Windows, Linux 모두 1급 시민
Kubernetes(K3s) 기본 내장 — 버전 선택, 활성화/비활성화 자유로움
런타임 선택의 유연성 — dockerd와 containerd 중 선택
GUI 제공 — 컨테이너·이미지·K8s 리소스를 시각적으로 관리
Helm 등 K8s 관련 도구 자동 설치

약점

UX가 Docker Desktop만큼 매끄럽지 않음 — 가끔 직관적이지 않은 부분이 있음
안정성 이슈 보고 — 버전에 따라 종종 버그가 보고됨 (성숙도가 Docker Desktop만큼은 아님)
macOS에서 OrbStack 대비 무거움 — 시작 시간, 자원 사용량 차이가 체감됨
자료가 상대적으로 적음 — 한국어 자료는 특히 적은 편

3. 설치 방법 (macOS, Apple Silicon)

Homebrew (권장)

brew install --cask rancher

설치 후 Applications에서 Rancher Desktop을 실행합니다.

공식 설치 파일

rancherdesktop.io에서 Apple Silicon용 .dmg를 받아 설치할 수 있습니다.

첫 실행 시 설정

처음 실행하면 다음을 묻는 화면이 뜹니다.

Container Engine: dockerd (moby) 또는 containerd 선택
Enable Kubernetes: K3s를 함께 띄울지 여부
Kubernetes Version: 사용할 K8s 버전 선택

처음에는 dockerd + Kubernetes 활성화를 선택하는 것이 가장 무난합니다. K3s가 부담스럽다면 비활성화해도 됩니다 (나중에 켤 수 있음).

설정을 마치면 VM이 부팅됩니다. 첫 실행은 1~2분 소요됩니다.

설치 확인

docker --version
docker run hello-world

# Kubernetes 활성화 시
kubectl get nodes

4. 기본 사용법

컨테이너 명령

런타임으로 dockerd를 선택했다면 표준 docker CLI 그대로입니다.

docker run -d -p 8080:80 --name web nginx
docker ps
docker compose up -d

containerd를 선택했다면 nerdctl을 사용합니다. 명령 체계는 docker와 거의 동일합니다.

nerdctl run -d -p 8080:80 --name web nginx
nerdctl ps
nerdctl compose up -d

Kubernetes 사용

K3s가 활성화되어 있으면 kubectl이 자동으로 컨텍스트를 잡아줍니다.

# 노드 확인
kubectl get nodes

# 간단한 nginx 배포
kubectl create deployment nginx --image=nginx
kubectl expose deployment nginx --port=80 --type=NodePort
kubectl get pods,svc

# Helm 사용 (자동 설치되어 있음)
helm version
helm repo add bitnami https://charts.bitnami.com/bitnami
helm install my-redis bitnami/redis

GUI 주요 화면

Rancher Desktop의 GUI에서 자주 쓰는 화면들:

General: 버전 정보, 자동 업데이트 설정
Container Engine: 런타임 전환 (dockerd ↔ containerd)
Kubernetes Settings: K8s 활성화/비활성화, 버전 변경
Containers: 실행 중인 컨테이너 시각적 관리
Images: 이미지 목록, push/pull
Port Forwarding: K8s 서비스 포트 포워딩 시각적 설정
Troubleshooting: 로그 확인, VM 재시작 등

자원 설정

GUI의 Preferences → Virtual Machine 또는 macOS 메뉴에서 Settings:

Memory: 기본 4GB, 무거운 작업 시 6~8GB 권장
CPUs: 기본 2개, 4개 정도가 일반적
Volume Mount Type: macOS에서 virtiofs 또는 9p 선택 (virtiofs 권장)

5. 실전 팁

런타임 전환

dockerd와 containerd를 자유롭게 전환할 수 있습니다. Preferences → Container Engine에서 변경 후 적용 시 VM이 재시작됩니다. 단, 두 런타임은 이미지 저장소를 공유하지 않으므로 전환 후엔 이미지를 다시 받아야 합니다.

Kubernetes 버전 바꾸기

K8s 학습이나 호환성 테스트를 할 때 유용합니다. Preferences → Kubernetes에서 버전을 선택하면 됩니다. 버전 변경 시 클러스터가 재구성되므로 기존 K8s 리소스는 사라집니다 (필요하면 백업).

Reset Kubernetes

K8s에 문제가 생기거나 깨끗하게 시작하고 싶을 때:

Preferences → Kubernetes → Reset Kubernetes

또는 CLI로:

rdctl shell
# 안에서 k3s 관련 작업

Apple Silicon에서 amd64 빌드

docker run --platform linux/amd64 some-image
docker buildx build --platform linux/amd64,linux/arm64 -t myapp .

Docker Desktop과 충돌 회피

Rancher Desktop과 Docker Desktop을 함께 깔면 docker CLI 경로가 충돌할 수 있습니다. 한쪽만 활성화하거나, docker context 명령으로 명시적 전환을 권장합니다.

docker context ls
docker context use rancher-desktop

Helm 차트 활용

Rancher Desktop은 Helm을 자동으로 설치해줍니다. 로컬에서 Helm 차트를 테스트하고 싶을 때 별도 설치 없이 바로 시작할 수 있습니다.

helm version
helm repo add bitnami https://charts.bitnami.com/bitnami
helm search repo bitnami

Traefik 비활성화 (선택)

K3s에는 기본적으로 Traefik(인그레스 컨트롤러)이 함께 설치됩니다. 필요 없다면 Preferences → Kubernetes → Options에서 비활성화할 수 있습니다.

6. 다른 OS에서는?

Windows: WSL2 백엔드를 사용해 동작합니다. Docker Desktop과 거의 동일한 사용 경험을 제공하며, Windows 사용자에게 가장 자연스러운 무료 대안입니다.
Linux: 패키지(rpm/deb) 또는 AppImage로 설치 가능. 다만 리눅스 사용자는 Docker Engine + Minikube/K3s 조합을 직접 쓰는 경우가 더 많습니다.

7. 어떤 사용자에게 적합한가

Rancher Desktop을 추천하는 경우:

로컬에서 Kubernetes를 자주 다루는 개발자 — K3s 내장이 가장 큰 매력입니다.
Docker Desktop 라이선스를 피하면서 GUI를 원하는 사용자 — 정확히 이 자리에 있는 도구입니다.
모든 OS에서 같은 도구를 쓰고 싶은 팀 — macOS·Windows·Linux 모두 동일하게 동작합니다.
Helm·K8s 도구를 자주 쓰는 사용자 — 함께 설치되어 편리합니다.
dockerd와 containerd를 모두 다뤄야 하는 사용자

다른 도구를 고려해야 하는 경우:

macOS에서 가능한 한 가벼운 환경을 원한다 → Colima, OrbStack
GUI 없이 CLI만 깔끔하게 쓰고 싶다 → Colima
Apple Silicon 최적화된 매끄러운 UX를 원한다 → OrbStack
rootless·멀티 유저 환경이 필요하다 → Podman
Kubernetes를 안 쓰는데 더 간단한 도구가 필요하다 → Colima 또는 OrbStack

정리

Rancher Desktop은 K3s를 내장한 무료 오픈소스 데스크톱 도구다
macOS·Windows·Linux 모두 1급 시민으로 지원
설치는 brew install --cask rancher, 첫 실행 시 런타임과 K8s 옵션 선택
dockerd ↔ containerd 전환, K8s 버전 선택, Helm 자동 통합 등 K8s 친화 기능이 차별점
macOS에서는 OrbStack보다 무겁지만, 모든 OS를 동일하게 지원하는 점은 큰 강점

다음 편에서는 철학이 가장 뚜렷한 도구 — Podman을 다룹니다. 데몬도, 루트 권한도 없이 컨테이너를 돌리는 도구. 그 구조적 차이가 왜 보안과 멀티 유저 환경에서 결정적인 차이를 만드는지 자세히 살펴보겠습니다.