Skip to main content
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 연동 옵션이 활성화됐는지 확인합니다.

​
설치 점검 목록

  • 관리자 권한/필수 도구 등 사전 요구사항을 먼저 확인했습니다.
  • 설치 후 버전 확인 명령어(--version)를 실행해 정상 설치를 검증했습니다.
  • PATH/환경변수 변경이 필요한 경우 터미널을 다시 열어 적용 여부를 확인했습니다.
  • 문제가 생겼을 때를 대비해 설치 로그 또는 스크린샷을 남겼습니다.

​
관련 문서

Setup 홈

운영체제별 설치 흐름을 다시 확인합니다.

다음: Ollama

다음 설치 단계를 이어서 진행합니다.