16 December 2025

1. Docker 설치 가이드

by NyangPolice

Docker 설치 가이드

Docker를 다양한 플랫폼에 설치하는 상세한 방법을 설명함.

[!NOTE] 시작하기 전에: Docker의 개념과 아키텍처를 먼저 이해하고 싶다면 Docker 기초: 개념 및 아키텍처 문서를 참고할 것.

Windows에 Docker 설치

Windows에서는 Docker Desktop for Windows를 사용함.

공식 문서: Install Docker Desktop on Windows

시스템 요구사항

Windows 10 64-bit: Pro, Enterprise, Education (Build 19041 이상)
Windows 11 64-bit: Home, Pro, Enterprise, Education
WSL 2 기능 활성화
하드웨어 가상화 지원 (BIOS에서 활성화 필요)

설치 단계

1단계: WSL 2 설치 및 활성화

PowerShell을 관리자 권한으로 실행 후:

# WSL 설치
wsl --install

# 또는 기존 시스템의 경우
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# Virtual Machine Platform 기능 활성화
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 시스템 재부팅

재부팅 후:

# WSL 2를 기본 버전으로 설정
wsl --set-default-version 2

# Linux 배포판 설치 (예: Ubuntu)
wsl --install -d Ubuntu

[!IMPORTANT] WSL 2 필수: Windows에서 Docker Desktop을 사용하려면 WSL 2가 반드시 필요함.

2단계: Docker Desktop 다운로드 및 설치

Docker Desktop for Windows 다운로드
다운로드한 Docker Desktop Installer.exe 실행
설치 마법사 따라 진행
- “Use WSL 2 instead of Hyper-V” 옵션 선택 (권장)
설치 완료 후 시스템 재부팅
Docker Desktop 실행

3단계: 설치 확인

# Docker 버전 확인
docker --version

# Docker 정보 확인
docker info

# 테스트 컨테이너 실행
docker run hello-world

Windows 문제 해결

WSL 2 설치 오류

# WSL 2 커널 업데이트 다운로드 및 설치
# https://aka.ms/wsl2kernel

Hyper-V 활성화 (필요 시)

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

macOS에 Docker 설치

macOS에서는 Docker Desktop for Mac을 사용함.

공식 문서: Install Docker Desktop on Mac

시스템 요구사항

macOS 11 (Big Sur) 이상
Apple Silicon (M1/M2/M3) 또는 Intel 프로세서
최소 4GB RAM (8GB 이상 권장)

설치 단계

1단계: Docker Desktop 다운로드

Docker Desktop for Mac 페이지에서 CPU 아키텍처에 맞는 버전 선택:

Apple Silicon (M1/M2/M3 칩)
Intel chip

[!TIP] CPU 확인: 메뉴 바 → Apple 로고 → “이 Mac에 관하여”에서 칩 종류를 확인할 수 있음.

2단계: 설치

다운로드한 Docker.dmg 파일 열기
Docker 아이콘을 Applications 폴더로 드래그
Applications에서 Docker 실행
시스템 권한 요청 시 비밀번호 입력
Docker Desktop이 시작될 때까지 대기

3단계: 설치 확인

터미널에서:

# Docker 버전 확인
docker --version

# Docker Compose 버전 확인
docker compose version

# 테스트 컨테이너 실행
docker run hello-world

macOS 설정 최적화

Docker Desktop 설정에서:

Settings → Resources → Advanced
- CPUs: 전체 CPU의 50-75%
- Memory: 전체 RAM의 25-50%
- Swap: 1-2GB
- Disk image size: 필요에 따라 조정 (기본 64GB)

[!TIP] 리소스 할당: 개발 환경에서는 CPU 4코어, 메모리 4-8GB 정도가 적절함. 필요에 따라 조정 가능함.

Rosetta 2 설치 (Apple Silicon)

일부 Intel 기반 이미지 실행을 위해 Rosetta 2가 필요할 수 있음:

softwareupdate --install-rosetta

Linux에 Docker 설치

Linux에서는 Docker Engine을 직접 설치함. 배포판별 설치 방법을 설명함.

공식 문서: Install Docker Engine on Linux

Ubuntu/Debian 계열

공식 문서: Install Docker Engine on Ubuntu

1단계: 기존 Docker 제거 (있는 경우)

sudo apt-get remove docker docker-engine docker.io containerd runc

2단계: 저장소 설정

# 필수 패키지 설치
sudo apt-get update
sudo apt-get install -y \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

# Docker 공식 GPG 키 추가
sudo mkdir -p /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 \
  $(lsb_release -cs) stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

3단계: Docker Engine 설치

# 패키지 인덱스 업데이트
sudo apt-get update

# Docker Engine, containerd, Docker Compose 설치
sudo apt-get install -y \
    docker-ce \
    docker-ce-cli \
    containerd.io \
    docker-buildx-plugin \
    docker-compose-plugin

4단계: Docker 서비스 시작

# Docker 서비스 시작
sudo systemctl start docker

# 부팅 시 자동 시작 설정
sudo systemctl enable docker

# 서비스 상태 확인
sudo systemctl status docker

5단계: 사용자 권한 설정 (선택사항)

Docker 명령을 sudo 없이 실행하려면:

# docker 그룹에 사용자 추가
sudo usermod -aG docker $USER

# 변경사항 적용 (로그아웃 후 재로그인 또는)
newgrp docker

# 또는 시스템 재부팅

[!WARNING] 보안 주의: docker 그룹에 사용자를 추가하면 root 권한과 동등한 권한을 얻게 됨. 신뢰할 수 있는 사용자에게만 권한을 부여할 것.

6단계: 설치 확인

# Docker 버전 확인
docker --version

# Docker 정보 확인
docker info

# 테스트 컨테이너 실행
docker run hello-world

CentOS/RHEL/Fedora 계열

공식 문서: Install Docker Engine on CentOS

1단계: 기존 Docker 제거

sudo yum remove docker \
    docker-client \
    docker-client-latest \
    docker-common \
    docker-latest \
    docker-latest-logrotate \
    docker-logrotate \
    docker-engine

2단계: 저장소 설정

# yum-utils 설치
sudo yum install -y yum-utils

# Docker 저장소 추가
sudo yum-config-manager \
    --add-repo \
    https://download.docker.com/linux/centos/docker-ce.repo

3단계: Docker Engine 설치

# Docker Engine 설치
sudo yum install -y \
    docker-ce \
    docker-ce-cli \
    containerd.io \
    docker-buildx-plugin \
    docker-compose-plugin

4단계: Docker 서비스 시작

# Docker 서비스 시작
sudo systemctl start docker

# 부팅 시 자동 시작
sudo systemctl enable docker

# 상태 확인
sudo systemctl status docker

5단계: 설치 확인

docker --version
docker run hello-world

Arch Linux

공식 문서: Docker - ArchWiki

# Docker 설치
sudo pacman -S docker

# Docker 서비스 시작
sudo systemctl start docker
sudo systemctl enable docker

# 사용자 권한 설정
sudo usermod -aG docker $USER

편리한 설치 스크립트 (테스트/개발 환경용)

공식 문서: Install using the convenience script

Docker는 대부분의 Linux 배포판에서 사용 가능한 편리한 설치 스크립트를 제공함.

# 스크립트 다운로드 및 실행
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# 설치 후 정리
rm get-docker.sh

# 사용자 권한 설정
sudo usermod -aG docker $USER
newgrp docker

[!WARNING] 프로덕션 환경 주의: 이 스크립트는 프로덕션 환경에서는 권장되지 않음. 테스트 및 개발 환경에서만 사용할 것.

[!TIP] 빠른 시작: 개인 개발 환경이나 테스트 서버에서는 이 스크립트가 가장 빠르고 편리함.

Docker Compose 설치

공식 문서: Install Docker Compose

최신 Docker Desktop과 Docker Engine에는 Docker Compose가 포함되어 있음. 하지만 구버전이나 별도 설치가 필요한 경우:

Linux에서 Docker Compose 설치

# 최신 버전 다운로드
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" \
    -o /usr/local/bin/docker-compose

# 실행 권한 부여
sudo chmod +x /usr/local/bin/docker-compose

# 버전 확인
docker-compose --version

설치 후 첫 단계

1. Hello World 실행

docker run hello-world

이 명령은:

로컬에서 hello-world 이미지를 찾음
없으면 Docker Hub에서 다운로드
컨테이너를 생성하고 실행
메시지를 출력하고 종료

2. 첫 번째 실용적인 컨테이너 실행

# Nginx 웹 서버 실행
docker run -d -p 8080:80 --name my-nginx nginx

# 웹 브라우저에서 http://localhost:8080 접속

3. 컨테이너 관리 기본

# 실행 중인 컨테이너 확인
docker ps

# 모든 컨테이너 확인
docker ps -a

# 컨테이너 중지
docker stop my-nginx

# 컨테이너 시작
docker start my-nginx

# 컨테이너 삭제
docker rm my-nginx

# 컨테이너 강제 삭제 (실행 중이어도)
docker rm -f my-nginx

4. 이미지 관리 기본

# 로컬 이미지 목록
docker images

# 이미지 검색
docker search nginx

# 이미지 다운로드
docker pull nginx:alpine

# 이미지 삭제
docker rmi nginx:alpine

# 사용하지 않는 이미지 정리
docker image prune

다음 단계

Docker 설치를 완료했다면:

Docker 기초: 개념 및 아키텍처: Docker의 핵심 개념 이해
Docker 기본 명령어: 컨테이너와 이미지 관리 (예정)
Dockerfile 작성: 커스텀 이미지 만들기 (예정)
Docker Compose: 멀티 컨테이너 애플리케이션 관리 (예정)

설치 과정에서 문제가 발생하면 공식 문서의 Troubleshooting 섹션을 참고할 것.

tags: docker - 설치 - installation - windows - macos - linux

Docker 카테고리의 글 목록

1. Docker 설치 가이드

2025년 12월 16일
0. Docker 기초: 개념 및 설치

2025년 12월 16일

Docker 카테고리 페이지로 이동 →

1. Docker 설치 가이드

Docker 설치 가이드

Windows에 Docker 설치

시스템 요구사항

설치 단계

1단계: WSL 2 설치 및 활성화

2단계: Docker Desktop 다운로드 및 설치

3단계: 설치 확인

Windows 문제 해결

WSL 2 설치 오류

Hyper-V 활성화 (필요 시)

macOS에 Docker 설치

시스템 요구사항

설치 단계

1단계: Docker Desktop 다운로드

2단계: 설치

3단계: 설치 확인

macOS 설정 최적화

Rosetta 2 설치 (Apple Silicon)

Linux에 Docker 설치

Ubuntu/Debian 계열

1단계: 기존 Docker 제거 (있는 경우)

2단계: 저장소 설정

3단계: Docker Engine 설치

4단계: Docker 서비스 시작

5단계: 사용자 권한 설정 (선택사항)

6단계: 설치 확인

CentOS/RHEL/Fedora 계열

1단계: 기존 Docker 제거

2단계: 저장소 설정

3단계: Docker Engine 설치

4단계: Docker 서비스 시작

5단계: 설치 확인

Arch Linux

편리한 설치 스크립트 (테스트/개발 환경용)

Docker Compose 설치

Linux에서 Docker Compose 설치

설치 후 첫 단계

1. Hello World 실행

2. 첫 번째 실용적인 컨테이너 실행

3. 컨테이너 관리 기본

4. 이미지 관리 기본

다음 단계

Docker 카테고리의 글 목록

1. Docker 설치 가이드

0. Docker 기초: 개념 및 설치