Skip to main content

Rancher Desktop 설치

Rancher Desktop은 macOS에서 컨테이너 개발 환경을 구성할 때 자주 사용하는 도구입니다.

사전 준비

  • Homebrew 설치 완료
  • 최소 8GB RAM 권장

설치 과정

1

Rancher Desktop 설치

아래 명령어를 실행합니다.
brew install --cask rancher
2

앱 실행 및 초기 설정

앱을 실행한 뒤 런타임(dockerd 또는 containerd)과 Kubernetes 사용 여부를 선택하세요.
open -a "Rancher Desktop"
3

Docker CLI 동작 확인

초기화가 끝나면 아래 명령어를 실행하세요.
docker version
docker run --rm hello-world

설치 확인하기

hello-world 컨테이너 메시지가 출력되면 정상입니다.

문제 해결

  • Cannot connect to the Docker daemon: Rancher Desktop 초기화가 끝날 때까지 1~2분 대기 후 재시도하세요.
  • docker 명령 미인식: 앱 설정에서 Docker CLI 연동 옵션이 활성화됐는지 확인하세요.