우분투 24.04 LTS 서버 Docker 설치

우분투 24.04 LTS(Noble Numbat) 서버에서 Docker 엔진을 설치하는 가장 권장되는 방법은 Docker 공식 리포지토리(Repository)를 사용하는 것입니다. 이 방법은 향후 업데이트를 apt 명령어로 편리하게 관리할 수 있어 가장 안정적입니다.

---

1. 사전 준비 (이전 버전 제거)

충돌을 방지하기 위해 이전에 설치되었을 수 있는 비공식 Docker 패키지를 삭제합니다.

1) Docker 서비스 중지

# sudo systemctl stop docker -> docker.service만 멈춤

sudo systemctl stop docker.service docker.socket
sudo systemctl stop containerd

2) Docker 패키지 제거

# 설정파일 유지 sudo apt remove

sudo apt purge $(dpkg --get-selections docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin | cut -f1)

3) 의존성 정리

# docker-ce에 의존성으로 설치된 docker-ce-rootless-extras 패키지 삭제됨

sudo apt autoremove

4) Docker 설치여부 확인

dpkg -l | grep -i docker

5) Docker 데이터 삭제 (선택)

# 이미지, 컨테이너, 볼륨 등 모든 데이터 삭제 (주의)

sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd

4) Docker GPG 키 및 저장소 제거 (선택)

sudo rm /etc/apt/keyrings/docker.asc
sudo rm /etc/apt/sources.list.d/docker.sources
sudo apt update

---

2. Docker 리포지토리 설정

Docker 공식 서버로부터 패키지를 내려받기 위해 GPG 키와 소스 리스트를 추가합니다.

1) 패키지 인덱스 업데이트 및 필수 패키지 설치

sudo apt update
sudo apt install ca-certificates curl

2) Docker 공식 GPG 키 추가

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

3) 리포지토리(Repository) 등록

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
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

---

3. Docker 엔진 설치

이제 Docker 엔진과 주요 플러그인(Compose 포함)을 설치합니다.

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

---

4. 설치 확인

Docker가 정상적으로 실행 중인지 테스트용 이미지를 실행해 봅니다.

sudo docker run hello-world

 

성공 시 출력

• Hello from Docker!

docker 서비스 상태 확인

• sudo systemctl status docker

docker 서비스 실행

• sudo systemctl start docker

---

5. sudo 없이 Docker 사용하기(선택 사항) 

기본적으로 Docker 명령어는 root 권한이 필요합니다. 매번 sudo를 붙이기 번거롭다면 현재 사용자를 docker 그룹에 추가하세요.

 

그룹 추가

• sudo usermod -aG docker $USER

설정 적용

• newgrp docker (혹은 재접속)

---

6. Docker 버전 확인

• docker --version
• docker compose version

---

7. 설치 주요 구성요소

구성 요소	설명
docker-ce	Docker 엔진 (커뮤니티 에디션)
docker-ce-cli	터미널에서 사용하는 Docker 명령줄 도구
containerd.io	컨테이너 실행 및 관리를 위한 런타임
docker-compose-plugin	여러 컨테이너를 관리하는 Docker Compose v2