✨ 안녕하세요! 이번 포스팅에서는 2025년 기준으로 Ubuntu, macOS, Windows에서 Docker와 Docker Compose를 설치하는 완전한 가이드를 실시간으로 정리해드릴게요.
이 글만 따라하시면, 10분 안에 개발 환경을 완성할 수 있어요! 🚀
🐳 1. Docker 설치 전 준비사항
✅ 설치 전 확인 사항
- 운영체제: Ubuntu 22.04 이상 / macOS 12 이상 / Windows 10 Pro 이상
- 관리자 권한 필요 (sudo 또는 관리자 계정)
- 인터넷 연결 (다운로드용)
> 💡 Tip: Docker는 리눅스 기반의 컨테이너 기술이므로, 모든 OS에서 동작하지만, Windows/macOS는 내부적으로 가상머신을 사용합니다.
🖥️ 2. Ubuntu 22.04/24.04에서 Docker 설치하기
Step 1: 패키지 업데이트 및 필요 패키지 설치
sudo apt update && sudo apt upgrade -y
sudo apt install apt-transport-https ca-certificates curl gnupg lsb-release -yStep 2: Docker 공식 GPG 키 추가
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpgStep 3: Docker 저장소 추가
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/nullStep 4: Docker 설치
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io -yStep 5: Docker 서비스 시작 및 부팅 시 자동 실행 설정
sudo systemctl enable docker
sudo systemctl start dockerStep 6: 사용자 권한 추가 (sudo 없이 사용하기)
sudo usermod -aG docker $USER> 🔄 로그아웃 후 다시 로그인해야 권한이 반영됩니다.
✅ 설치 확인
docker --version
docker run hello-world> 🎉 출력 결과: Hello from Docker! → 정상 설치 완료!
🍏 3. macOS에서 Docker 설치하기 (Docker Desktop)
Step 1: 공식 사이트에서 다운로드
👉 https://www.docker.com/products/docker-desktop
Download Docker Desktop for Mac클릭
Step 2: 설치 파일 실행 및 설치
.dmg파일을 열고, Docker Desktop.app을 Applications 폴더로 드래그- Applications 폴더에서 Docker Desktop 실행
Step 3: 설치 완료 후 설정
- 첫 실행 시 “Use Docker Compose V2” 선택 (권장)
- 자동 시작 설정 (옵션)
- 메모리, CPU 할당량 조정 (기본 2GB RAM, 2코어 권장)
✅ 설치 확인
터미널에서 실행:
docker --version
docker run hello-world> 🎯 출력 결과: Hello from Docker! → 성공!
💻 4. Windows 10/11에서 Docker 설치하기 (Docker Desktop)
Step 1: 공식 사이트에서 다운로드
👉 https://www.docker.com/products/docker-desktop
Download Docker Desktop for Windows클릭
Step 2: 설치 파일 실행
Docker Desktop Installer.exe실행- Windows 10/11 Pro는 WSL2 기반 설치를 권장
- 기본 설치 옵션 그대로 진행
> ⚠️ 주의: Windows Home 사용자는 WSL2 지원이 필요 → WSL2 설치 가이드 참고
Step 3: 설치 완료 후 실행
- 설치 완료 후 Docker Desktop 실행
- 처음 실행 시 “Start Docker Desktop” 클릭
- 상태 표시줄에 🐳 Docker Desktop 아이콘이 나타나면 성공!
✅ 설치 확인
PowerShell 또는 CMD에서 실행:
docker --version
docker run hello-world> ✅ 출력: Hello from Docker! → 정상 설치 완료!
🧩 5. Docker Compose 설치 방법
> 💡 Docker Compose는 Docker Desktop에 기본 포함되어 있어 Ubuntu에서는 별도 설치 필요
✅ Ubuntu에서 Docker Compose 설치 (Docker Desktop 사용 X)
Step 1: 최신 버전 다운로드
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-composeStep 2: 실행 권한 부여
sudo chmod +x /usr/local/bin/docker-composeStep 3: 설치 확인
docker-compose --version> ✅ 출력 예: docker-compose version 2.29.0, build abc123
> 🎯 Tip: docker-compose 명령어를 docker compose로 사용하는 V2 버전도 지원됨.
> docker compose up처럼 사용 가능합니다. (공식 권장 방식)
✅ Docker Compose V2 사용 예시 (추천)
# 예시: 웹 앱 + MySQL 컨테이너 실행
# docker-compose.yml 파일 생성
version: '3.8'
services:
web:
image: nginx:alpine
ports:
- "8080:80"
volumes:
- ./html:/usr/share/nginx/html
db:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: example
ports:
- "3306:3306"# 컨테이너 실행
docker compose up -d> 🌐 http://localhost:8080 접속 → Nginx 기본 화면 확인!
🧪 6. 설치 후 체크리스트 (완전히 잘 됐는지 확인!)
| 항목 | 확인 방법 | 예시 |
|---|---|---|
| Docker 설치 | docker --version |
Docker version 25.0.0, build abc123 |
| Docker 작동 | docker run hello-world |
Hello from Docker! |
| Docker Compose 설치 | docker compose --version |
Docker Compose version 2.29.0 |
| 컨테이너 실행 | docker compose up -d |
web_1 ... running |
| 웹 접속 | http://localhost:8080 |
Nginx 기본 페이지 |
📌 7. 자주 묻는 질문 (FAQ)
❓ Docker Compose가 안 되어요!
- Ubuntu 사용 중이라면
docker-compose설치를 잊지 말아요. docker compose로 사용하려면docker-compose명령어를docker compose로 대체 가능.
❓ 권한 오류 발생 (Permission denied)?
sudo usermod -aG docker $USER실행 후 재로그인 필수!
❓ Windows에서 WSL2가 안 됩니다?
Windows 10/11 Pro이상이어야 함.Windows Features→Windows Subsystem for Linux활성화 필요.
❓ Docker Desktop이 느려요?
- 메모리 할당량을 4GB 이상으로 조정
Settings→Resources→Memory조절
🏁 마무리: 이제 당신도 컨테이너 마스터!
> 🎯 Docker + Docker Compose 는 현대 웹 개발의 핵심 도구입니다.
> 로컬에서 빠르게 개발 환경을 구성하고, CI/CD 파이프라인에도 쉽게 통합 가능해요!
📌 이 글을 따라하면, 10분 만에 개발 환경 완성!
👉 이제 docker-compose.yml 하나로 웹 + DB + Redis를 한 번에 배포해보세요!
💬 필요한 도움이 있다면? 아래 댓글로 질문 주세요!
🔧 예제 파일도 제공해드릴게요 — docker-compose.yml, Dockerfile 예시도 요청해주세요! 😊
#Docker #DockerCompose #개발환경설정 #컨테이너 #2025최신가이드 G