Ubuntu 26 에 docker 와 docker compose 설치

 

Ubuntu 26 기본 저장소에는 docker-compose-plugin 패키지가 없을 수 있습니다. 그래서 지금은 Docker만 먼저 설치하고, Compose는 별도로 확인/설치하면 됩니다.

먼저 이걸 실행하세요.

sudo apt update
sudo apt install -y docker.io
sudo systemctl enable --now docker

설치 확인:

docker --version
sudo systemctl status docker

그 다음 Compose가 같이 들어왔는지 확인합니다.

docker compose version

만약 여기서도 docker: 'compose' is not a docker command 비슷하게 나오면, Ubuntu 기본 저장소 방식으로는 Compose가 없는 상태입니다. 이 경우 Docker 공식 저장소를 추가해서 설치하는 게 가장 깔끔합니다. Docker 공식 문서도 Linux에서 Compose v2는 Docker CLI 플러그인 형태로 docker compose 명령을 사용한다고 안내합니다. (Docker Documentation)

아래 그대로 실행하세요.

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

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

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

그 다음 Docker 공식 패키지로 설치합니다.

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

서비스 실행:

sudo systemctl enable --now docker

사용자를 docker 그룹에 추가:

sudo usermod -aG docker $USER
newgrp docker

확인:

docker --version
docker compose version
docker ps

이제 다시 GitLab 실행:

cd ~/gitlab-docker
docker compose up -d

혹시 VERSION_CODENAME 때문에 공식 저장소에서 Ubuntu 26 코드명이 아직 지원되지 않는다는 오류가 나오면, 임시로 Ubuntu 24.04 코드명인 noble 저장소를 쓰는 방법도 있습니다.