Docker 설치 방법 총정리! Ubuntu·Rocky Linux·Windows·macOS에서 Docker 설치하기

작성자:

Docker를 배우기 위해 가장 먼저 해야 할 일은 Docker를 자신의 환경에 설치하는 것입니다.

Docker는 Linux에서 시작된 기술이지만 현재는 Windows, macOS에서도 Docker Desktop을 통해 쉽게 사용할 수 있습니다. 특히 실무에서는 Ubuntu, Rocky Linux, RHEL과 같은 Linux 서버에서 Docker Engine을 사용하는 경우가 가장 많습니다.

이번 글에서는 Ubuntu, Rocky Linux, Windows, macOS에서 Docker를 설치하는 방법과 설치 후 정상적으로 동작하는지 확인하는 방법까지 자세히 알아보겠습니다.

Docker 설치 전 확인 사항

Docker를 설치하기 전에 운영체제를 확인합니다.

Linux에서는 다음 명령을 사용합니다.

cat /etc/os-release

커널 버전도 확인합니다.

uname -r

Docker는 최신 커널에서 가장 안정적으로 동작합니다.

Ubuntu에서 Docker 설치

먼저 패키지 목록을 업데이트합니다.

sudo apt update

필요한 패키지를 설치합니다.

sudo apt install \
ca-certificates \
curl \
gnupg

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

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

Docker를 설치합니다.

sudo apt update

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

Rocky Linux에서 Docker 설치

기존 Podman 관련 패키지가 있다면 확인합니다.

sudo dnf remove docker*

Docker 저장소를 등록합니다.

sudo dnf config-manager --add-repo=https://download.docker.com/linux/centos/docker-ce.repo

Docker를 설치합니다.

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

서비스를 시작합니다.

sudo systemctl enable docker

sudo systemctl start docker

상태를 확인합니다.

systemctl status docker

Windows에서 Docker 설치

Windows에서는 Docker Desktop을 설치합니다.

설치 과정은 다음과 같습니다.

  1. Docker Desktop 다운로드
  2. 설치 프로그램 실행
  3. WSL2 활성화
  4. 재부팅
  5. Docker Desktop 실행

설치가 완료되면 PowerShell에서 확인합니다.

docker --version

macOS에서 Docker 설치

macOS 역시 Docker Desktop을 사용합니다.

설치 절차는 다음과 같습니다.

  1. Docker Desktop 다운로드
  2. dmg 파일 실행
  3. Applications 폴더로 이동
  4. Docker 실행
  5. 권한 승인

설치 후 터미널에서 확인합니다.

docker version

Docker 서비스 확인

Linux에서는 Docker 서비스가 실행 중인지 확인합니다.

systemctl status docker

실행 중이라면 다음과 같이 표시됩니다.

Active: active (running)

Docker 버전 확인

설치 후 가장 먼저 실행하는 명령입니다.

docker --version

예시

Docker version 28.x.x

Docker 상세 정보 확인

docker info

확인 가능한 내용은 다음과 같습니다.

  • Docker Engine 버전
  • Storage Driver
  • CPU 개수
  • 메모리
  • Registry 정보
  • Network Driver

Hello World 실행

설치가 정상인지 테스트합니다.

docker run hello-world

동작 과정은 다음과 같습니다.

Docker Hub

↓

hello-world Image 다운로드

↓

Container 생성

↓

실행

↓

메시지 출력

성공하면 다음과 비슷한 메시지가 출력됩니다.

Hello from Docker!

Docker 자동 시작 설정

Linux에서는 서버 부팅 시 Docker가 자동 실행되도록 설정하는 것이 일반적입니다.

sudo systemctl enable docker

확인

systemctl is-enabled docker

Docker 서비스 재시작

설정을 변경한 뒤에는 서비스를 재시작합니다.

sudo systemctl restart docker

서비스 중지

sudo systemctl stop docker

서비스 시작

sudo systemctl start docker

일반 사용자로 Docker 사용하기

기본적으로 Docker는 root 권한이 필요합니다.

매번 sudo를 입력하기 번거롭다면 사용자를 docker 그룹에 추가합니다.

sudo usermod -aG docker $USER

변경 사항을 적용하려면 로그아웃 후 다시 로그인합니다.

그 후에는 다음처럼 사용할 수 있습니다.

docker ps

Docker 설치 확인 체크리스트

다음 항목을 모두 확인하면 설치가 완료된 것입니다.

  • Docker 설치 완료
  • Docker Daemon 실행 중
  • Docker 버전 확인 성공
  • docker info 정상 출력
  • docker run hello-world 성공
  • 일반 사용자 권한으로 Docker 실행 가능

설치 중 자주 발생하는 오류

Permission denied

permission denied while trying to connect to the Docker daemon socket

원인

  • Docker 그룹 미등록
  • Docker Daemon 미실행

해결

sudo usermod -aG docker $USER

또는

sudo systemctl start docker

Cannot connect to Docker daemon

Cannot connect to the Docker daemon

원인

Docker 서비스가 실행되지 않음

확인

systemctl status docker

hello-world 실행 실패

인터넷 연결 또는 Docker Hub 접근 여부를 확인합니다.

실무에서 자주 사용하는 명령어

Docker 버전 확인

docker --version

Docker 정보 확인

docker info

Docker 서비스 확인

systemctl status docker

Docker 시작

sudo systemctl start docker

Docker 재시작

sudo systemctl restart docker

Docker 자동 실행

sudo systemctl enable docker

테스트 실행

docker run hello-world

실무 사례

예를 들어 Ubuntu 24.04 서버에 신규 웹 서비스를 배포한다고 가정해 보겠습니다.

운영자는 다음 순서로 작업합니다.

  1. Docker 공식 저장소 등록
  2. Docker Engine 설치
  3. Docker 서비스 시작 및 자동 실행 설정
  4. docker --version으로 설치 확인
  5. docker run hello-world로 정상 동작 테스트
  6. docker pull nginx로 웹 서버 이미지 다운로드
  7. 이후 Nginx, Redis, MySQL 등의 컨테이너를 실행하여 서비스 구축

이처럼 Docker 설치는 이후 모든 컨테이너 운영의 출발점이 되는 중요한 과정입니다.

자주 묻는 질문

Ubuntu 기본 저장소의 Docker를 설치해도 되나요?

가능하지만 권장되지는 않습니다. 최신 기능과 보안 업데이트를 위해 Docker 공식 저장소에서 설치하는 것이 좋습니다.

Windows에서도 Linux 컨테이너를 실행할 수 있나요?

가능합니다. Docker Desktop은 WSL2를 이용해 Linux 컨테이너를 실행할 수 있습니다.

Docker 설치 후 반드시 hello-world를 실행해야 하나요?

필수는 아니지만 설치가 정상적으로 완료되었는지 확인하는 가장 간단한 방법이므로 권장됩니다.

마무리

Docker는 운영체제에 따라 설치 방법은 조금씩 다르지만, 설치 후 사용하는 명령어는 거의 동일합니다. Docker Engine이 정상적으로 설치되고 hello-world 컨테이너가 실행된다면 이후에는 Image, Container, Dockerfile, Volume, Network 등 Docker의 핵심 기능을 차근차근 학습할 수 있습니다.

댓글 남기기