Skip to main content

Docker Engine 설치

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

사전 준비

  • Ubuntu 24.04
  • sudo 권한

설치 과정

1

필수 패키지 설치

sudo apt update
sudo apt install -y ca-certificates curl gnupg
2

Docker 저장소 등록

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
3

Docker 패키지 설치

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
4

현재 사용자 권한 추가

sudo usermod -aG docker $USER
newgrp docker

설치 확인하기

docker --version
docker compose version
docker run --rm hello-world

문제 해결

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