Docker

운영체제별 Docker 설치 가이드: Windows, macOS, Linux 완벽 정리

TechLogbook 2025. 2. 18. 15:57

🖥️ Windows에서 Docker 설치

✅ 설치 전 요구 사항

  • Windows 10 (Pro, Enterprise, Education) 64비트 이상 또는 Windows 11
  • WSL 2 활성화 필요 (선택 사항)
  • Hyper-V 활성화 필요
  • 최소 4GB RAM

🔹 설치 방법

  1. Docker 공식 사이트에서 Docker Desktop 다운로드
  2. 설치 프로그램 실행 후 기본 설정으로 설치 진행
  3. 설치 완료 후 Docker Desktop 실행
  4. CMD 또는 PowerShell에서 다음 명령어 실행:
    docker --version
    docker run hello-world

🛠 문제 해결

WSL 2가 활성화되지 않은 경우 다음 명령 실행:

wsl --set-default-version 2

🍎 macOS에서 Docker 설치

✅ 설치 전 요구 사항

  • macOS 11 (Big Sur) 이상
  • Apple Silicon (M1/M2) 또는 Intel 기반 Mac 지원
  • 최소 4GB RAM

🔹 설치 방법

  1. Docker 공식 사이트에서 Docker Desktop 다운로드
  2. 다운로드한 .dmg 파일 실행 후 Docker 아이콘을 응용 프로그램 폴더로 이동
  3. Docker Desktop 실행 후 사용 약관 동의
  4. 터미널에서 다음 명령어 실행:
    docker --version
    docker run hello-world

🛠 문제 해결

Apple Silicon Mac에서 Rosetta 2가 필요할 경우 다음 명령 실행:

softwareupdate --install-rosetta

🐧 Linux에서 Docker 설치

✅ 설치 전 요구 사항

  • Ubuntu, Debian, CentOS, Fedora 등 지원
  • sudo 또는 root 권한 필요

🔹 Ubuntu/Debian 설치 방법

  1. 기존 Docker 패키지 제거:
    sudo apt remove docker docker-engine docker.io containerd runc
  2. 필수 패키지 설치:
    sudo apt update
    sudo apt install -y ca-certificates curl gnupg
  3. Docker GPG 키 추가:
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo tee /etc/apt/keyrings/docker.asc > /dev/null
    sudo chmod a+r /etc/apt/keyrings/docker.asc
  4. Docker 리포지토리 등록 및 설치:
    sudo apt update
    sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  5. 서비스 활성화:
    sudo systemctl start docker
    sudo systemctl enable docker

🛠 문제 해결

Docker 실행 시 권한 오류 발생 시:

sudo usermod -aG docker $USER
newgrp docker

📌 설치 후 공통 확인 사항

Docker가 정상적으로 설치되었는지 확인하려면 다음 명령을 실행하세요.

docker --version
docker run hello-world

출력이 정상적으로 표시되면 Docker 설치가 완료된 것입니다.

🚀 이제 운영체제별 Docker 설치를 완료했습니다. 이후 단계로 Docker Compose 설정, 컨테이너 실행 실습 등을 진행할 수 있습니다.