[이제와서 시작하는 Docker 마스터하기 - 기초편 #2] Docker 설치 및 환경 설정

게시 2025/07/16

By YonYonWare

39 분읽는 시간

시작하기 전에

“Docker 설치가 어려울까요?” 걱정하지 마세요! 터미널이 뭔지 잘 모르는 분들도 따라할 수 있게 하나하나 자세히 설명해드리겠습니다.

Docker 설치는 생각보다 간단합니다. 프로그램 하나 깔고, 몇 번 클릭하고, 재시작 한 번이면 끝입니다. 이 글에서는 “왜 이렇게 하는지”도 함께 설명하니까, 안심하고 따라오세요!

이번 글에서 배울 내용:

내 컴퓨터에 맞는 Docker 버전 찾기
클릭 몇 번으로 설치 완료하기
설치가 제대로 됐는지 확인하는 3가지 방법
문제가 생겼을 때 해결하는 방법

Docker 설치 전 확인사항

내 컴퓨터 사양 확인하기

Docker를 설치하기 전에 내 컴퓨터가 Docker를 실행할 수 있는지 확인해야 합니다. 걱정 마세요, 최근 5년 이내 컴퓨터라면 대부분 괜찮습니다!

시스템 요구사항 비교표

운영체제	최소 요구사항	권장 사양	비고
Windows	• Windows 10 64-bit (Build 15063 이상) • 4GB RAM • 10GB 여유 공간	• Windows 11 • 8GB RAM 이상 • SSD 스토리지	Windows 10 Home도 가능! WSL 2만 설치하면 됩니다
macOS	• macOS 10.15 이상 • 4GB RAM • Intel 또는 M 시리즈 칩	• macOS 12 이상 • 8GB RAM 이상	M1/M2/M3 Mac은 더 빠릅니다! Intel Mac도 문제없어요
Linux	• Ubuntu 18.04 이상 • 2GB RAM	• 최신 LTS 버전 • 4GB RAM 이상	Ubuntu가 제일 쉬워요 다른 배포판도 가능

내 Windows 버전 확인하기

방법 1: 설정에서 확인

Windows 키 + I 눌러서 설정 열기
“시스템” 클릭
맨 아래 “정보” 클릭
“Windows 사양” 부분 확인

방법 2: 명령어로 확인

Windows 키 + R 눌러서 실행 창 열기
winver 입력하고 엔터
버전 정보 확인

Windows 10 Home 사용자라면? 걱정 마세요! Pro/Enterprise가 아니어도 Docker를 쓸 수 있습니다. WSL 2(Windows 안의 작은 Linux 컴퓨터)를 설치하면 됩니다. 이 글에서 자세히 설명해드릴게요!

내 Mac 칩 확인하기

화면 왼쪽 상단 Apple 로고 클릭
“이 Mac에 관하여” 클릭
칩 또는 프로세서 확인
- “Apple M1/M2/M3” → Apple Silicon
- “Intel Core i…” → Intel

Docker 설치 방법 선택 가이드

graph TD
    A[Docker 설치 시작] --> B{운영체제는?}
    B -->|Windows| C[Windows 버전 확인]
    B -->|macOS| D[칩셋 확인]
    B -->|Linux| E[배포판 확인]
    
    C --> F{Windows 10/11<br/>Pro/Enterprise?}
    F -->|Yes| G[Docker Desktop<br/>추천]
    F -->|No| H[WSL2 +<br/>Docker Desktop]
    
    D --> I{Apple Silicon?}
    I -->|Yes| J[Docker Desktop<br/>Apple Silicon]
    I -->|No| K[Docker Desktop<br/>Intel]
    
    E --> L{GUI 필요?}
    L -->|Yes| M[Docker Desktop<br/>for Linux]
    L -->|No| N[Docker Engine<br/>CLI]
    
    style A fill:#f9f,stroke:#333,stroke-width:2px
    style G fill:#bfb,stroke:#333,stroke-width:2px
    style H fill:#bfb,stroke:#333,stroke-width:2px
    style J fill:#bfb,stroke:#333,stroke-width:2px
    style K fill:#bfb,stroke:#333,stroke-width:2px
    style M fill:#bfb,stroke:#333,stroke-width:2px
    style N fill:#bfb,stroke:#333,stroke-width:2px

Windows에서 Docker 설치하기

설치 순서 한눈에 보기

flowchart LR
    A[시작] --> B[Docker Desktop<br/>다운로드]
    B --> C[WSL 2 확인]
    C --> D{WSL 2<br/>설치됨?}
    D -->|No| E[WSL 2 설치]
    D -->|Yes| F[Docker Desktop<br/>설치]
    E --> F
    F --> G[재시작]
    G --> H[Docker 실행]
    H --> I[완료!]

    style A fill:#f96,stroke:#333,stroke-width:2px
    style I fill:#9f6,stroke:#333,stroke-width:2px

1단계: Docker Desktop 다운로드

Docker Desktop이 뭔가요? Docker를 쉽게 쓰게 해주는 프로그램입니다. 명령어 입력 없이 마우스 클릭으로 Docker를 사용할 수 있어요!

다운로드 방법:

Docker 공식 웹사이트 접속
파란색 “Download for Windows” 버튼 클릭
다운로드한 Docker Desktop Installer.exe 파일 찾기 (보통 다운로드 폴더에 있어요)

2단계: WSL 2 설정 (Windows 10 Home 필수!)

WSL 2가 뭔가요? Windows Subsystem for Linux 2의 약자로, Windows 안에서 Linux를 실행할 수 있게 해주는 기술입니다. 쉽게 말하면 “Windows 안의 작은 Linux 컴퓨터”라고 생각하면 됩니다!

왜 필요한가요? Docker는 원래 Linux용으로 만들어졌어요. Windows에서 Docker를 쓰려면 WSL 2가 필요합니다. 걱정 마세요, 설치는 간단해요!

WSL 2 설치하기 (초보자용 가이드)

방법 1: 간단한 방법 (Windows 10 버전 2004 이상, Windows 11)

PowerShell 관리자 권한으로 열기
- Windows 키 누르기
- “PowerShell” 검색
- 마우스 오른쪽 버튼 → “관리자 권한으로 실행”
- 파란 창이 나타나면 성공!
명령어 입력하기
1 wsl --install
- 이 명령어 하나면 WSL 2가 자동으로 설치됩니다!
- 몇 분 정도 걸려요 (커피 한 잔 마시면서 기다리세요 ☕)
컴퓨터 재시작
- 설치가 끝나면 컴퓨터를 재시작해야 해요
- 꼭 재시작해야 적용됩니다!

방법 2: 수동 설치 (위 방법이 안 될 때)

PowerShell 관리자 권한으로 열기 (위와 동일)

다음 명령어들을 하나씩 입력

  
# 1. WSL 기능 활성화
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 2. 가상 머신 기능 활성화
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

각 명령어를 복사해서 붙여넣고 엔터를 누르세요
“작업을 완료했습니다” 메시지가 나오면 성공!

컴퓨터 재시작
재시작 후 WSL 2를 기본으로 설정
1 wsl --set-default-version 2
Linux 커널 업데이트 다운로드
- 이 링크 클릭
- 다운로드한 파일 실행해서 설치
- “Next” 버튼만 계속 누르면 끝!

WSL 2 설치 확인하기

  
# PowerShell에서 이 명령어 입력
wsl --status

“기본 버전: 2”라고 나오면 성공! 🎉

3단계: Docker Desktop 설치

설치 파일 실행
- 다운로드한 Docker Desktop Installer.exe 더블클릭
설치 옵션 선택
- “Use WSL 2 instead of Hyper-V” 체크박스 꼭 체크! ✅
- “Add shortcut to desktop” 체크 (바탕화면에 아이콘 생성)
설치 진행
- “OK” 버튼 클릭
- 5-10분 정도 기다리기 (인내심 필요! 🕐)
- “Installation succeeded” 메시지가 나오면 성공!
컴퓨터 재시작
- “Close and restart” 버튼 클릭
- 또 재시작이에요 (마지막입니다!)

4단계: Docker 첫 실행

Docker Desktop 실행
- 바탕화면의 Docker 아이콘 더블클릭
- 또는 시작 메뉴에서 “Docker Desktop” 검색
이용 약관 동의
- 처음 실행하면 약관 동의 창이 나와요
- “Accept” 버튼 클릭
Docker 시작 대기
- 화면 하단 작업 표시줄에 Docker 고래 아이콘이 나타나요 🐳
- 아이콘이 가만히 있으면 Docker가 실행된 거예요!
- 움직이면 아직 시작 중… 조금만 더 기다려주세요

Windows 설치 체크리스트

설치하기 전에 이것들을 확인해보세요:

Windows 10 (64-bit, Build 15063 이상) 또는 Windows 11
컴퓨터 재시작 해도 괜찮은 상황 (작업 중인 파일 저장!)
최소 10GB 여유 공간 (C 드라이브)
인터넷 연결 (다운로드 필요)
최소 1시간의 여유 시간 (설치 + 재시작 + 설정)

macOS에서 Docker 설치하기

Mac은 Windows보다 설치가 훨씬 쉬워요! 프로그램 하나만 깔면 끝입니다.

내 Mac 칩 확인하기

먼저 내 Mac이 어떤 칩을 사용하는지 확인해야 해요:

확인 방법:

화면 왼쪽 상단 Apple 로고 () 클릭
“이 Mac에 관하여” 클릭
칩 또는 프로세서 부분 확인

화면에 보이는 내용	칩 종류	Docker 버전
Apple M1/M2/M3/M4	Apple Silicon	Docker Desktop for Apple Silicon
Intel Core i5/i7/i9	Intel	Docker Desktop for Intel

Apple Silicon이 뭐가 좋나요?

더 빠르고 배터리 효율이 좋아요
요즘 나온 Mac은 대부분 Apple Silicon이에요
Intel Mac도 Docker 쓰는 데 아무 문제 없어요!

macOS 설치 프로세스

graph TD
    A[Docker.dmg 다운로드] --> B[DMG 파일 실행]
    B --> C[Docker를 Applications로 드래그]
    C --> D[Docker 첫 실행]
    D --> E{권한 요청}
    E -->|승인| F[Docker 초기화]
    F --> G[상태바에 Docker 아이콘]
    G --> H[설치 완료!]

    style A fill:#f9f,stroke:#333,stroke-width:2px
    style H fill:#9f6,stroke:#333,stroke-width:2px

1단계: Docker Desktop 다운로드

Docker 공식 웹사이트 접속
본인의 칩에 맞는 버전 선택
- Apple Silicon: “Download for Mac - Apple Silicon”
- Intel: “Download for Mac - Intel Chip”
Docker.dmg 파일 다운로드 완료 대기

2단계: Docker 설치

DMG 파일 열기
- 다운로드 폴더에서 Docker.dmg 더블클릭
- 새 창이 나타나요
Applications 폴더로 드래그
- Docker 고래 아이콘을 Applications 폴더로 드래그
- 그냥 마우스로 끌어다 놓으면 돼요!
- 복사가 완료될 때까지 잠시 대기
DMG 창 닫기
- 이제 DMG 창은 닫아도 돼요
- 휴지통에 “Docker.dmg 꺼내기” 클릭

3단계: Docker 첫 실행

Docker 실행
- Finder → Applications → Docker 더블클릭
- 또는 Spotlight(⌘ + Space)에서 “Docker” 검색
보안 확인
- “인터넷에서 다운로드한 응용 프로그램입니다” 경고가 나올 수 있어요
- “열기” 버튼 클릭
권한 요청 승인
- “Docker가 변경을 가하려고 합니다” 메시지
- Mac 비밀번호 입력
- “승인” 또는 “OK” 클릭
서비스 약관 동의
- “I accept the terms” 체크
- “Accept” 버튼 클릭
Docker 시작 대기
- 화면 상단 메뉴바에 Docker 고래 아이콘이 나타나요 🐳
- 아이콘이 움직이면 아직 시작 중
- 가만히 있으면 준비 완료!

Apple Silicon 사용자 추가 팁

Rosetta 2가 필요할 수도 있어요

일부 오래된 Docker 이미지는 Intel용으로 만들어졌어요. Apple Silicon Mac에서 이런 이미지를 실행하려면 Rosetta 2가 필요합니다.

Rosetta 2 설치하기:

  
# 터미널 열기 (⌘ + Space → "Terminal" 검색)
# 다음 명령어 입력
softwareupdate --install-rosetta

현재 아키텍처 확인:

  
uname -m
# arm64 → Apple Silicon
# x86_64 → Intel

언제 설치해야 하나요?

지금 당장은 안 해도 돼요
나중에 필요하면 Docker가 알려줄 거예요
그때 설치해도 늦지 않아요!

Linux(Ubuntu)에서 Docker 설치하기

1. 기존 Docker 제거

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

2. 필요한 패키지 설치

  
sudo apt-get update
sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

3. Docker 공식 GPG 키 추가

  
sudo mkdir -m 0755 -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

4. 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

5. Docker Engine 설치

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

6. 사용자를 docker 그룹에 추가

  
sudo usermod -aG docker $USER
# 로그아웃 후 다시 로그인하거나 다음 명령 실행
newgrp docker

Docker 설치 제대로 됐는지 확인하기

설치했다고 끝이 아니에요! 제대로 설치됐는지 확인해봐야 합니다. 3가지 방법으로 확인해볼 거예요.

설치 확인 단계

flowchart TD
    A[Docker 설치 완료] --> B[docker --version]
    B --> C{버전 출력?}
    C -->|Yes| D[docker info]
    C -->|No| E[설치 문제 해결]
    D --> F{시스템 정보?}
    F -->|Yes| G[docker run hello-world]
    F -->|No| E
    G --> H{Hello 메시지?}
    H -->|Yes| I[설치 성공!]
    H -->|No| E

    style A fill:#f9f,stroke:#333,stroke-width:2px
    style I fill:#9f6,stroke:#333,stroke-width:2px
    style E fill:#f99,stroke:#333,stroke-width:2px

방법 1: 버전 확인하기 (30초 소요)

터미널/명령 프롬프트 여는 법:

Windows: Windows 키 + R → cmd 입력 → 엔터
Mac: ⌘ + Space → “Terminal” 검색 → 엔터
Linux: Ctrl + Alt + T

명령어 입력:

docker --version

정상적인 출력 예시:

Docker version 24.0.7, build afdd53b

이런 메시지가 나오면?

✅ 버전 번호가 나왔다 → Docker 설치 성공!
❌ “docker는 내부 또는 외부 명령이 아닙니다” → 설치 실패 또는 재시작 필요
❌ “command not found: docker” → 설치 실패 또는 PATH 문제

방법 2: 상세 정보 확인하기 (1분 소요)

명령어 입력:

docker info

정상적인 출력 예시:

Client: Docker Engine - Community
 Version:    24.0.7
 Context:    default
 ...

Server:
 Containers: 0
  Running: 0
  Paused: 0
  Stopped: 0
 Images: 0
 ...

무슨 정보가 나오나요?

Docker 버전
실행 중인 컨테이너 개수
다운로드한 이미지 개수
시스템 리소스 정보

이 정보들이 주르륵 나오면 Docker가 제대로 실행되고 있는 겁니다!

방법 3: 첫 번째 컨테이너 실행해보기 (2분 소요)

이제 진짜 Docker를 사용해볼 시간이에요! 간단한 테스트 컨테이너를 실행해봅시다.

명령어 입력:

docker run hello-world

무슨 일이 일어나나요?

Docker가 “hello-world”라는 이미지를 찾아요
로컬에 없으면 인터넷에서 자동으로 다운로드해요
다운로드한 이미지로 컨테이너를 만들어요
컨테이너가 메시지를 출력하고 종료돼요

정상적인 출력 예시:

Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
c1ec31eb5944: Pull complete
Digest: sha256:1234567890...
Status: Downloaded newer image for hello-world:latest

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.

“Hello from Docker!” 메시지가 보이면? 🎉 축하합니다! Docker 설치가 완벽하게 완료되었습니다! 🎉

설치 확인 요약표

명령어	소요 시간	확인 내용	예상 결과
`docker --version`	30초	Docker 설치 여부	`Docker version 24.0.x, build xxxxx`
`docker info`	1분	Docker 실행 상태	컨테이너, 이미지, 시스템 정보 출력
`docker run hello-world`	2분	컨테이너 실행 가능 여부	`Hello from Docker!` 메시지

다음 단계: Docker Desktop 둘러보기

명령어 확인이 끝났다면, Docker Desktop 앱도 열어봅시다!

Windows/Mac:

Docker Desktop 아이콘 클릭
메인 화면에서 다음을 확인할 수 있어요:
- Containers: 실행 중인 컨테이너 목록
- Images: 다운로드한 이미지 목록
- Volumes: 데이터 저장 공간
- Settings: 설정 메뉴

방금 실행한 hello-world 컨테이너를 찾아볼까요?

Containers 탭 클릭
목록에서 “hello-world” 찾기
상태가 “Exited”로 표시돼요 (이미 실행 완료됨)

이제 진짜 Docker를 쓸 준비가 다 됐어요! 🚀

Docker Desktop 기본 설정

Docker Desktop 설정 메뉴 구조

graph TD
    A[Docker Desktop 설정] --> B[General]
    A --> C[Resources]
    A --> D[Docker Engine]
    A --> E[Experimental Features]
    
    B --> B1[Start Docker Desktop<br/>when you log in]
    B --> B2[Use Docker Compose V2]
    
    C --> C1[Advanced]
    C --> C2[File Sharing]
    C --> C3[Proxies]
    
    C1 --> C11[CPUs]
    C1 --> C12[Memory]
    C1 --> C13[Swap]
    C1 --> C14[Disk image size]
    
    style A fill:#f9f,stroke:#333,stroke-width:2px

권장 리소스 설정

리소스	최소값	권장값	설명
CPU	2 cores	4+ cores	빌드 속도와 성능에 영향
Memory	2 GB	8+ GB	동시 실행 컨테이너 수에 영향
Swap	1 GB	2 GB	메모리 부족 시 사용
Disk	20 GB	60+ GB	이미지와 컨테이너 저장 공간

주요 설정 항목

1. 리소스 설정

위치: Settings → Resources → Advanced
설정 방법: 슬라이더로 조정
적용: Apply & Restart 클릭

2. 파일 공유 설정

Windows/Mac: Settings → Resources → File Sharing
용도: 호스트-컨테이너 간 파일 공유
팁: 개발 프로젝트 폴더 추가

3. 네트워크 프록시

위치: Settings → Resources → Proxies
설정 항목: HTTP/HTTPS 프록시 주소
기업 환경: 사내 프록시 서버 정보 입력

Docker 기본 명령어 익히기

Docker 명령어 구조

graph LR
    A[docker] --> B[명령어]
    B --> C[옵션]
    C --> D[대상]
    
    A2[docker] --> B2[container]
    B2 --> C2[run]
    C2 --> D2[-it]
    D2 --> E2[ubuntu]
    
    style A fill:#f9f,stroke:#333,stroke-width:2px
    style A2 fill:#9f9,stroke:#333,stroke-width:2px

필수 Docker 명령어 정리

분류	명령어	설명	예시
정보 확인	`docker version`	Docker 버전 정보	`docker version`
	`docker info`	시스템 전체 정보	`docker info`
	`docker --help`	도움말 표시	`docker --help`
이미지	`docker images`	로컬 이미지 목록	`docker images`
	`docker pull`	이미지 다운로드	`docker pull nginx:latest`
	`docker search`	이미지 검색	`docker search ubuntu`
컨테이너	`docker ps`	실행 중인 컨테이너	`docker ps`
	`docker ps -a`	모든 컨테이너	`docker ps -a`
	`docker run`	컨테이너 실행	`docker run hello-world`

첫 번째 연습 명령어

  
# 1. Docker 버전 확인
docker version

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

# 3. 다운로드된 이미지 확인
docker images

# 4. 컨테이너 실행
docker run -d -p 8080:80 nginx:alpine

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

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

문제 해결 가이드 (Troubleshooting)

설치 중에 문제가 생겼나요? 걱정 마세요! 대부분의 문제는 쉽게 해결할 수 있어요. 아래에서 내 상황과 비슷한 문제를 찾아보세요.

자주 발생하는 문제 Top 5

문제 1: “docker는 내부 또는 외부 명령이 아닙니다” (Windows)

증상:

'docker'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다.

원인:

Docker Desktop이 제대로 설치되지 않았어요
또는 설치 후 재시작하지 않았어요

해결 방법:

Docker Desktop이 실행 중인지 확인
- 작업 표시줄에 Docker 고래 아이콘이 있나요? 🐳
- 없으면 시작 메뉴에서 “Docker Desktop” 실행
컴퓨터 재시작
- 설치 후 꼭 재시작해야 해요!
- 재시작 안 하면 Docker가 작동하지 않아요
재설치
- Docker Desktop 제거
- 다시 다운로드해서 설치
- 재시작!

문제 2: “Cannot connect to the Docker daemon” (모든 OS)

증상:

Cannot connect to the Docker daemon at unix:///var/run/docker.sock.
Is the docker daemon running?

원인: Docker가 실행되고 있지 않아요 (Docker 엔진이 꺼져 있음)

해결 방법:

Windows/Mac:

Docker Desktop 실행
작업 표시줄/메뉴바의 Docker 아이콘 확인
아이콘이 움직이면 시작 중… 조금만 기다리기
가만히 있으면 준비 완료!

Linux:

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

# Docker 서비스 시작
sudo systemctl start docker

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

문제 3: “WSL 2 installation is incomplete” (Windows)

증상:

WSL 2 installation is incomplete.
The WSL 2 Linux kernel is now installed using a separate MSI update package.

원인: WSL 2 커널 업데이트가 필요해요

해결 방법:

WSL 2 커널 업데이트 다운로드
다운로드한 파일 실행
설치 완료
컴퓨터 재시작
Docker Desktop 다시 실행

문제 4: “Permission denied” (Linux/Mac)

증상:

Got permission denied while trying to connect to the Docker daemon socket

원인: Docker를 실행할 권한이 없어요

해결 방법 (Linux):

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

# 2. 로그아웃 후 다시 로그인
# 또는 다음 명령어 실행
newgrp docker

# 3. 확인
docker ps

해결 방법 (Mac):

Docker Desktop 완전히 종료
Docker Desktop 다시 시작
권한 요청이 나오면 승인

문제 5: Docker Desktop이 느리거나 멈춤

증상:

Docker Desktop이 시작되지 않아요
명령어 입력이 느려요
컴퓨터가 느려졌어요

원인: 리소스 부족 또는 설정 문제

해결 방법:

리소스 설정 조정
- Docker Desktop 열기
- Settings → Resources
- CPU: 2-4 cores로 줄이기
- Memory: 2-4GB로 줄이기
- Apply & Restart

Docker 정리

# 사용하지 않는 컨테이너, 이미지 삭제
docker system prune -a

재시작
- Docker Desktop 완전히 종료
- 컴퓨터 재시작
- Docker Desktop 다시 시작

운영체제별 문제 해결 빠른 참조

문제 유형	Windows	macOS	Linux
Docker 명령어 인식 안 됨	• Docker Desktop 실행 확인 • 재시작 필수 • 재설치	• Docker Desktop 재시작 • PATH 확인	• docker 서비스 시작 • PATH 확인
권한 오류	• 관리자 권한으로 실행 • WSL 재시작	• Docker Desktop 재시작 • 권한 승인	• docker 그룹 추가 • 로그아웃 후 재로그인
WSL 2 오류	• 커널 업데이트 설치 • Windows 업데이트 • BIOS 가상화 확인	(해당 없음)	(해당 없음)
느림/멈춤	• 리소스 설정 줄이기 • WSL 메모리 제한 • Windows Defender 제외	• 리소스 설정 줄이기 • 디스크 공간 확인	• 메모리 확인 • 스왑 설정

문제 해결 플로우차트

graph TD
    A[Docker 오류 발생] --> B{어떤 오류?}
    B -->|명령어 인식 안 됨| C[Docker 실행 확인]
    B -->|연결 실패| D[Docker 데몬 확인]
    B -->|권한 오류| E[권한 설정]
    B -->|WSL 오류| F[WSL 2 설정]

    C --> C1[Docker Desktop 실행]
    C --> C2[재시작]

    D --> D1[Docker 서비스 시작]
    D --> D2[Docker Desktop 재시작]

    E --> E1[docker 그룹 추가]
    E --> E2[관리자 권한]

    F --> F1[커널 업데이트]
    F --> F2[WSL 재설치]

    style A fill:#f99,stroke:#333,stroke-width:2px

유용한 디버깅 명령어

Docker 상태 확인:

  
# Docker 버전
docker --version

# Docker 상세 정보
docker info

# 실행 중인 컨테이너
docker ps

# 모든 컨테이너 (정지된 것 포함)
docker ps -a

리소스 확인:

  
# Docker가 사용하는 디스크 공간
docker system df

# 상세 정보
docker system df -v

청소 명령어:

  
# 사용하지 않는 컨테이너 삭제
docker container prune

# 사용하지 않는 이미지 삭제
docker image prune

# 전체 정리 (주의: 모든 정지된 컨테이너, 사용하지 않는 이미지 삭제)
docker system prune -a

그래도 안 되면?

Docker Desktop 로그 확인
- Docker Desktop → Troubleshoot → View Logs
- 오류 메시지 찾기
공식 문서 참조
- Docker Desktop 문제 해결 가이드
커뮤니티에 질문
- Docker Community Forums
- Stack Overflow (영어)
처음부터 다시 설치
- Docker 완전히 제거
- 컴퓨터 재시작
- 다시 설치
- 이 가이드 처음부터 천천히 따라하기

자주 묻는 질문 (FAQ)

Q1: Windows 10 Home 버전인데 Docker를 쓸 수 있나요?

A: 네, 가능해요! 예전에는 Pro 버전만 가능했지만, 이제는 Home 버전도 WSL 2를 설치하면 Docker를 사용할 수 있습니다. 이 글의 Windows 설치 가이드를 따라하시면 됩니다.

Q2: Docker Desktop을 꼭 써야 하나요? 명령어만 쓰면 안 되나요?

A: Docker Desktop 없이도 Docker Engine만 설치해서 명령어로 사용할 수 있어요. 하지만 초보자에게는 Docker Desktop을 추천합니다:

GUI로 쉽게 관리 가능
자동 업데이트
쉬운 설정 관리
좋은 문서와 지원

명령어에 익숙하고 리소스를 절약하고 싶다면 Linux에서 Docker Engine만 사용하는 것도 좋은 선택이에요.

Q3: Docker를 설치하면 컴퓨터가 느려지나요?

A: Docker Desktop이 실행 중일 때는 약간의 리소스를 사용합니다:

기본: 약 2GB RAM, 2 CPU cores
컨테이너 실행 시: 추가 리소스 사용

해결책:

Settings에서 리소스 제한 조정
사용하지 않을 때는 Docker Desktop 종료
가벼운 컨테이너 이미지 사용 (예: alpine)

Q4: Docker를 설치하면 용량을 얼마나 차지하나요?

설치 용량:

Docker Desktop: 약 500MB - 1GB
WSL 2 (Windows): 약 300MB - 500MB

사용 중 용량:

이미지를 다운로드하면 추가 공간 필요
예: nginx 이미지 약 140MB, ubuntu 이미지 약 70MB
docker system df로 확인 가능

권장 여유 공간: 최소 10GB, 권장 20GB 이상

Q5: 재시작을 꼭 해야 하나요?

A: 네, 특히 Windows에서는 꼭 필요해요:

WSL 2 설치 후: 재시작 필수
Docker Desktop 설치 후: 재시작 필수 (Windows)
Mac은 재시작 안 해도 대부분 잘 작동해요

왜 재시작이 필요한가요?

시스템 구성 요소 업데이트
커널 모듈 로드
환경 변수 적용

Q6: Docker Hub 계정이 필요한가요?

A: 설치와 기본 사용에는 필요 없어요. 하지만 다음 경우에 필요합니다:

이미지를 Docker Hub에 올릴 때
다운로드 속도 제한 회피 (익명: 시간당 100회, 로그인: 200회)
비공개 이미지 사용

나중에 필요하면 만들면 돼요. 무료입니다!

Q7: Mac M1/M2에서 모든 Docker 이미지가 작동하나요?

A: 대부분은 작동하지만, 주의사항이 있어요:

ARM64 이미지: 네이티브로 빠르게 실행
x86 이미지: Rosetta 2를 통해 실행 (약간 느림)
일부 오래된 이미지: 호환성 문제 가능

팁:

공식 이미지는 대부분 ARM64 지원
docker pull --platform linux/amd64 이미지명으로 x86 이미지 명시 가능

Q8: 회사 방화벽이 있는데 Docker를 설치할 수 있나요?

A: 가능하지만 추가 설정이 필요할 수 있어요:

프록시 설정
- Docker Desktop → Settings → Resources → Proxies
- HTTP/HTTPS 프록시 주소 입력
IT 팀에 확인
- docker.com, docker.io 접근 가능한지
- 포트 443, 80이 열려있는지
오프라인 설치
- 집에서 다운로드
- USB로 회사 PC에 복사
- 오프라인 설치 가능

Q9: Docker와 가상 머신(VirtualBox, VMware)을 같이 쓸 수 있나요?

Windows (Hyper-V 사용 시):

VirtualBox와 충돌 가능
WSL 2 사용 시 대부분 호환

Windows (WSL 2 사용 시):

VirtualBox 6.1 이상: 호환
VMware 15.5 이상: 호환

Mac/Linux:

대부분 문제없이 같이 사용 가능

Q10: Docker를 완전히 제거하려면 어떻게 하나요?

Windows:

Docker Desktop 제거 (프로그램 추가/제거)
%APPDATA%\Docker 폴더 삭제
WSL 2 제거 (선택 사항)

Mac:

Docker.app을 휴지통으로 드래그
~/Library/Group Containers/group.com.docker 삭제
~/Library/Containers/com.docker.docker 삭제

Linux:

  
# Docker 제거
sudo apt-get purge docker-ce docker-ce-cli containerd.io

# 설정 파일 삭제
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd

마무리

축하합니다! 🎉 Docker 설치를 완료했습니다. 이제 컨테이너의 세계로 들어갈 준비가 되었어요.

지금까지 배운 것: ✅ 내 컴퓨터에 맞는 Docker 버전 선택하기 ✅ Docker 설치하고 실행하기 ✅ 설치 확인하는 3가지 방법 ✅ 문제 해결 방법 ✅ 자주 묻는 질문들

다음 편에서 배울 것:

첫 번째 컨테이너 실행하기
컨테이너 내부에 들어가보기
컨테이너 시작, 정지, 삭제하기
Docker 기본 명령어 실습

설치 과정에서 어려움이 있었나요? 댓글로 물어보세요! 다음 편에서 더 재미있는 내용으로 만나요.

기억하세요: Docker는 어렵지 않아요. 천천히 따라오시면 누구나 할 수 있습니다! 💪

시작하기 전에

Docker 설치 전 확인사항

내 컴퓨터 사양 확인하기

시스템 요구사항 비교표

내 Windows 버전 확인하기

내 Mac 칩 확인하기

Docker 설치 방법 선택 가이드

Windows에서 Docker 설치하기

설치 순서 한눈에 보기

1단계: Docker Desktop 다운로드

2단계: WSL 2 설정 (Windows 10 Home 필수!)

WSL 2 설치하기 (초보자용 가이드)

WSL 2 설치 확인하기

3단계: Docker Desktop 설치

4단계: Docker 첫 실행

Windows 설치 체크리스트

macOS에서 Docker 설치하기

내 Mac 칩 확인하기

macOS 설치 프로세스

1단계: Docker Desktop 다운로드

2단계: Docker 설치

3단계: Docker 첫 실행

Apple Silicon 사용자 추가 팁

Linux(Ubuntu)에서 Docker 설치하기

1. 기존 Docker 제거

2. 필요한 패키지 설치

3. Docker 공식 GPG 키 추가

4. Docker 저장소 설정

5. Docker Engine 설치

6. 사용자를 docker 그룹에 추가

Docker 설치 제대로 됐는지 확인하기

설치 확인 단계

방법 1: 버전 확인하기 (30초 소요)

방법 2: 상세 정보 확인하기 (1분 소요)

방법 3: 첫 번째 컨테이너 실행해보기 (2분 소요)

설치 확인 요약표

다음 단계: Docker Desktop 둘러보기

Docker Desktop 기본 설정

Docker Desktop 설정 메뉴 구조

권장 리소스 설정

주요 설정 항목

1. 리소스 설정

2. 파일 공유 설정

3. 네트워크 프록시

Docker 기본 명령어 익히기

Docker 명령어 구조

필수 Docker 명령어 정리

첫 번째 연습 명령어

문제 해결 가이드 (Troubleshooting)

자주 발생하는 문제 Top 5

문제 1: “docker는 내부 또는 외부 명령이 아닙니다” (Windows)

문제 2: “Cannot connect to the Docker daemon” (모든 OS)

문제 3: “WSL 2 installation is incomplete” (Windows)

문제 4: “Permission denied” (Linux/Mac)

문제 5: Docker Desktop이 느리거나 멈춤

운영체제별 문제 해결 빠른 참조

문제 해결 플로우차트

유용한 디버깅 명령어

그래도 안 되면?

자주 묻는 질문 (FAQ)

Q1: Windows 10 Home 버전인데 Docker를 쓸 수 있나요?

Q2: Docker Desktop을 꼭 써야 하나요? 명령어만 쓰면 안 되나요?

Q3: Docker를 설치하면 컴퓨터가 느려지나요?

Q4: Docker를 설치하면 용량을 얼마나 차지하나요?

Q5: 재시작을 꼭 해야 하나요?

Q6: Docker Hub 계정이 필요한가요?

Q7: Mac M1/M2에서 모든 Docker 이미지가 작동하나요?

Q8: 회사 방화벽이 있는데 Docker를 설치할 수 있나요?

Q9: Docker와 가상 머신(VirtualBox, VMware)을 같이 쓸 수 있나요?

Q10: Docker를 완전히 제거하려면 어떻게 하나요?

마무리

Docker의 세계에 오신 것을 환영합니다! 🐳

📚 Docker 마스터하기 시리즈

🐳 기초편 (입문자용 - 5편)

💼 실전편 (중급자용 - 6편)

🚀 고급편 (전문가용 - 9편)

인기 태그