> ## 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.

# Docker Engine

Ubuntu에서는 Docker Engine을 직접 설치해 컨테이너 개발 환경을 구성하는 방식을 권장합니다.

## 사전 준비

* Ubuntu 24.04
* `sudo` 권한

## 설치 과정

<Steps>
  <Step title="필수 패키지 설치">
    ```bash theme={null}
    sudo apt update
    sudo apt install -y ca-certificates curl gnupg
    ```
  </Step>

  <Step title="Docker 저장소 등록">
    ```bash theme={null}
    sudo install -m 0755 -d /etc/apt/keyrings
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
    sudo chmod a+r /etc/apt/keyrings/docker.gpg

    echo \
      "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
      $(. /etc/os-release && echo ${UBUNTU_CODENAME}) stable" \
      | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
    ```
  </Step>

  <Step title="Docker 패키지 설치">
    ```bash theme={null}
    sudo apt update
    sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
    ```
  </Step>

  <Step title="현재 사용자 권한 추가">
    ```bash theme={null}
    sudo usermod -aG docker $USER
    newgrp docker
    ```
  </Step>
</Steps>

## 설치 확인하기

```bash theme={null}
docker --version
docker compose version
docker run --rm hello-world
```

## 문제 해결

* **권한 오류(permission denied)**: 그룹 반영을 위해 로그아웃/로그인 후 다시 시도합니다.
* **서비스 미기동**: `sudo systemctl status docker`로 상태를 확인합니다.

## 설치 점검 목록

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

## 관련 문서

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

  <Card title="다음: NVIDIA Driver" icon="arrow-right" href="/setup/ubuntu/nvidia-driver">
    다음 설치 단계를 이어서 진행합니다.
  </Card>
</CardGroup>