Docker 및 Docker Compose 설치 가이드

등록일: 2026-05-04

---

본 문서는 Xubuntu(Ubuntu 기반) 환경에서 Docker Engine 및 Docker Compose를 설치하고 사용자 권한을 설정하는 과정을 정리함.

1. 시스템 업데이트 및 필수 패키지 설치

설치 전 시스템 패키지 리스트를 최신화하고, HTTPS를 통해 저장소를 사용할 수 있도록 관련 패키지를 설치함.

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

2. Docker 공식 GPG 키 추가

Docker 패키지의 무결성을 검증하기 위한 GPG 키를 등록함.

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

3. Docker 저장소(Repository) 등록

시스템 소스 리스트에 Docker 공식 저장소를 추가함.

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

sudo apt update

4. Docker 엔진 및 Compose 설치

핵심 패키지들을 일괄 설치함.

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

5. 사용자 권한 설정 (Post-installation)

매번 sudo를 사용하는 번거로움을 피하기 위해 현재 사용자를 docker 그룹에 추가함.

sudo usermod -aG docker $USER

주의: 설정을 적용하려면 로그아웃 후 다시 로그인하거나 newgrp docker 명령어를 실행해야 함.

6. 설치 확인

설치된 Docker 버전과 Compose 버전을 확인하여 정상 설치 여부를 판별함.

docker --version
docker compose version