> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baeum.ai.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# Rancher Desktop

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

## 사전 준비

* [Homebrew](/setup/macos/homebrew) 설치 완료
* 최소 8GB RAM 권장

## 설치 과정

<Steps>
  <Step title="Rancher Desktop 설치">
    아래 명령어를 실행합니다.

    ```bash theme={null}
    brew install --cask rancher
    ```
  </Step>

  <Step title="앱 실행 및 초기 설정">
    앱을 실행한 뒤 런타임(`dockerd` 또는 `containerd`)과 Kubernetes 사용 여부를 선택합니다.

    ```bash theme={null}
    open -a "Rancher Desktop"
    ```
  </Step>

  <Step title="Docker CLI 동작 확인">
    초기화가 끝나면 아래 명령어를 실행합니다.

    ```bash theme={null}
    docker version
    docker run --rm hello-world
    ```
  </Step>
</Steps>

## 설치 확인하기

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

## 문제 해결

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

## 설치 점검 목록

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

## 관련 문서

<CardGroup cols={2}>
  <Card title="Setup 홈" icon="house" href="/setup/index">
    운영체제별 설치 흐름을 다시 확인합니다.
  </Card>

  <Card title="다음: Ollama" icon="arrow-right" href="/setup/macos/ollama">
    다음 설치 단계를 이어서 진행합니다.
  </Card>
</CardGroup>