Ubuntu에서 Docker Compose는 이제 별도 바이너리를 내려받지 않고 Docker 공식 저장소에서 docker-compose-plugin을 설치해 docker compose(띄어쓰기 형태)로 쓰는 것이 표준이다. 예전에 쓰던 파이썬 기반 docker-compose(v1)는 더 이상 유지보수되지 않는다.1 이 글은 apt 저장소 등록부터 설치, 동작 확인, 기존 v1에서 옮기는 방법까지 순서대로 정리한다.
어떤 Ubuntu 버전에서 설치할 수 있나?
Docker 공식 문서가 현재 지원 대상으로 꼽는 Ubuntu는 24.04 LTS, 22.04 LTS 등 최신 LTS 계열이며 64비트만 지원한다.2 20.04는 목록에 없다. Ubuntu 20.04의 표준 지원은 2025년 5월에 끝났고, 이후에는 Ubuntu Pro를 통한 보안 유지보수만 남아 있다.3 새로 서버를 만든다면 22.04 이상을 권한다.

예전 설치 방식과 무엇이 달라졌나?
| 구분 | 예전 방식(v1) | 현재 방식(v2) |
|---|---|---|
| 명령어 | docker-compose |
docker compose |
| 구현 | 파이썬 도구 | Go로 작성, Docker CLI에 통합 |
| 설치 | GitHub에서 바이너리를 받아 /usr/local/bin에 복사 |
apt의 docker-compose-plugin |
| 업데이트 | 수동으로 다시 내려받기 | apt upgrade로 함께 갱신 |
| 유지보수 | 종료 | 진행 중 |
구분 내용은 Docker 공식 이전 안내를 따랐다.1 또한 원문에서 쓰던 apt-key add와 add-apt-repository 방식 대신, 현재 문서는 키 파일을 /etc/apt/keyrings에 두고 docker.sources 파일로 저장소를 등록한다.2
기존 패키지는 어떻게 정리하나?
배포판이 제공하는 비공식 패키지(docker.io, docker-compose 등)와 충돌할 수 있으므로 먼저 제거한다. 이미지·컨테이너·볼륨이 있는 /var/lib/docker/는 자동으로 지워지지 않는다.2
sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc | cut -f1)
Docker 저장소는 어떻게 등록하나?
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt update
위 명령은 공식 문서의 절차 그대로다.2 배포판 코드명(jammy, noble 등)이 자동으로 들어가므로 직접 고칠 부분은 없다.
Docker Engine과 Compose는 어떻게 설치하나?
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
한 줄로 Engine과 Compose 플러그인이 함께 설치된다.2 특정 버전을 고정하려면 apt list --all-versions docker-ce로 버전 문자열을 확인한 뒤 docker-ce=<버전> 형태로 지정한다.

설치가 제대로 됐는지 어떻게 확인하나?
sudo systemctl status docker
sudo docker run hello-world
docker compose version
hello-world 컨테이너가 안내 문구를 출력하고 종료되면 Engine은 정상이다.2 docker compose version에 버전이 표시되면 Compose도 준비된 것이다. 매번 sudo를 쓰기 번거롭다면 사용자를 docker 그룹에 추가할 수 있지만, 이 그룹은 사실상 root 권한과 같으므로 신뢰할 수 있는 계정에만 적용한다.4
기존 docker-compose.yml과 명령은 그대로 쓸 수 있나?
기존 compose 파일은 명령만 docker-compose up -d에서 docker compose up -d로 바꿔 실행하는 경우가 많다. 다만 파일 호환성은 서비스마다 다를 수 있으므로 먼저 테스트 환경에서 확인하고, 스크립트가 docker-compose를 호출하고 있다면 함께 치환한다. Compose v1은 더 이상 유지보수되지 않으므로 v2로 옮기는 것이 권장된다.1 플러그인 설치와 버전 확인은 Compose 설치 문서에도 같은 방식으로 안내돼 있다.5
정리하면 순서는 세 단계다. 비공식 패키지 제거, Docker 저장소 등록, docker-compose-plugin까지 한 번에 설치. 이후 docker compose up -d로 서비스를 올리고 docker compose stop, docker compose down으로 멈추거나 정리한다.
- Docker Docs, Migrate to Compose v2 — https://docs.docker.com/compose/migrate/
- Docker Docs, Install Docker Engine on Ubuntu — https://docs.docker.com/engine/install/ubuntu/
- Ubuntu, Release cycle — https://ubuntu.com/about/release-cycle
- Docker Docs, Linux post-installation steps — https://docs.docker.com/engine/install/linux-postinstall/
- Docker Docs, Install the Compose plugin — https://docs.docker.com/compose/install/linux/