도커(Docker Desktop) 윈도우 설치 및 사용법 완벽 가이드
안녕하세요, 우리들의 주파수 구독자 여러분! 오늘은 개발 공부를 시작하면 누구나 한 번은 마주치는 “도커(Docker)“를 윈도우 PC에 설치하고 실제로 써보는 법을 처음부터 끝까지 정리해드리겠습니다. “도커가 뭔지는 알겠는데 설치하다가 오류만 나고 포기했다”는 분들을 위한 글입니다.
목차
- 도커가 뭔가요? (3줄 요약)
- 설치 전 필수 준비물 (WSL2, 가상화)
- Docker Desktop 설치 단계별 가이드
- 첫 컨테이너 실행해보기
- 자주 발생하는 오류와 해결법
- Docker Desktop vs Podman Desktop 비교
- FAQ
- 핵심 요약
1. 도커가 뭔가요?
도커는 프로그램을 “컨테이너”라는 격리된 상자에 담아 실행하는 기술입니다. 쉽게 말하면 이렇습니다.
- 내 컴퓨터에 직접 설치하지 않고 프로그램(서버, 데이터베이스 등)을 돌려볼 수 있습니다.
- “내 컴퓨터에서는 되는데 다른 컴퓨터에서는 안 돼요” 문제가 거의 사라집니다. 컨테이너 안의 환경이 항상 동일하기 때문입니다.
- 필요 없어지면 컨테이너만 삭제하면 끝. 레지스트리나 시스템 파일이 지저분해지지 않습니다.
예를 들어 MySQL, Redis, Node.js 서버를 PC에 직접 설치하지 않고도 명령어 한 줄로 실행했다가, 필요 없으면 바로 지울 수 있습니다.
2. 설치 전 필수 준비물
윈도우용 Docker Desktop은 내부적으로 WSL2(Windows Subsystem for Linux 2) 를 백엔드로 사용합니다. 아래 2가지가 먼저 되어 있어야 설치가 매끄럽습니다.
2-1. 윈도우 버전 확인
- Windows 11 (모든 에디션) 또는 Windows 10 버전 2004 이상 (빌드 19041+).
Win + R→winver입력 후 Enter로 버전을 확인하세요.
2-2. WSL2 설치
WSL2가 이미 있다면 건너뛰어도 됩니다. 없다면 관리자 권한 PowerShell에서 아래 한 줄이면 끝입니다.
wsl --install재부팅을 요구하면 재부팅하세요. WSL2 설치 과정이 더 자세히 궁금하다면 별도로 다룬 WSL2 설치 가이드를 참고하세요.
2-3. 가상화(Virtualization) 활성화 확인
작업 관리자(Ctrl+Shift+Esc) → 성능 탭 → CPU 항목에서 “가상화: 사용”으로 표시되는지 확인합니다. “사용 안 함”이면 BIOS/UEFI 설정에서 Intel VT-x 또는 AMD-V를 켜야 합니다. 메인보드 제조사마다 메뉴 위치가 다르니 “제품명 + 가상화 활성화”로 검색해 진입 키(보통 Del 또는 F2)를 확인하세요.
3. Docker Desktop 설치 단계별 가이드
3-1. 다운로드
docker.com 공식 다운로드 페이지에서 Docker Desktop for Windows를 받습니다. 반드시 공식 사이트에서만 받으세요.
3-2. 설치 실행
- 받은
Docker Desktop Installer.exe를 실행합니다. - “Use WSL 2 instead of Hyper-V” 옵션에 체크된 상태로 진행합니다(기본값).
- 설치가 끝나면 재부팅을 요구할 수 있습니다. 재부팅하세요.
3-3. 첫 실행 및 로그인
- 바탕화면의 Docker Desktop 아이콘을 실행합니다.
- 처음 실행 시 서비스 약관 동의 화면이 나옵니다.
- Docker Hub 계정으로 로그인(선택)하면 이미지를 올리고 내려받을 때 편합니다. 계정이 없다면 건너뛰어도 기본 기능 사용에는 문제없습니다.
- 좌측 하단 고래 아이콘이 초록색으로 바뀌고 “Engine running”이 뜨면 설치 완료입니다.
3-4. 설치 확인
PowerShell이나 명령 프롬프트를 열고 아래 명령을 입력합니다.
docker --version
docker run hello-worldhello-world 컨테이너가 실행되며 “Hello from Docker!” 메시지가 나오면 정상 설치된 것입니다.
4. 첫 컨테이너 실행해보기
실전 감각을 위해 웹서버 컨테이너를 하나 띄워보겠습니다.
docker run -d -p 8080:80 --name my-nginx nginx-d: 백그라운드 실행-p 8080:80: 내 PC의 8080번 포트를 컨테이너의 80번 포트에 연결--name my-nginx: 컨테이너 이름 지정
실행 후 브라우저에서 http://localhost:8080에 접속하면 nginx 환영 페이지가 보입니다.
자주 쓰는 명령어를 표로 정리했습니다.
| 명령어 | 설명 |
|---|---|
docker ps | 실행 중인 컨테이너 목록 |
docker ps -a | 멈춘 것 포함 전체 목록 |
docker stop <이름> | 컨테이너 정지 |
docker rm <이름> | 컨테이너 삭제 |
docker images | 다운로드된 이미지 목록 |
docker rmi <이미지ID> | 이미지 삭제 |
docker logs <이름> | 컨테이너 로그 확인 |
docker exec -it <이름> bash | 컨테이너 내부 터미널 접속 |
Docker Desktop을 설치하면 GUI도 함께 제공됩니다. Containers 탭에서 실행 중인 컨테이너를 클릭 몇 번으로 중지·삭제·로그 확인까지 할 수 있어서, 명령어가 아직 익숙하지 않다면 GUI부터 써봐도 좋습니다.
5. 자주 발생하는 오류와 해결법
“WSL 2 installation is incomplete” 오류
WSL2 커널 업데이트가 안 된 상태입니다. Microsoft WSL2 커널 업데이트 패키지를 받아 설치한 뒤 Docker Desktop을 재시작하세요.
“Hardware assisted virtualization and data execution protection must be enabled in the BIOS” 오류
앞서 2-3단계의 가상화 설정이 꺼져 있는 경우입니다. BIOS에서 VT-x/AMD-V를 켜고 재부팅하세요.
Docker Desktop이 계속 “Starting…”에서 멈춤
- Docker Desktop을 완전히 종료(작업 관리자에서 관련 프로세스 종료)합니다.
- PowerShell(관리자)에서
wsl --shutdown실행. - Docker Desktop을 다시 실행합니다.
그래도 안 되면 Settings → Troubleshoot → Reset to factory defaults로 초기화해보세요. 단, 기존에 받은 이미지와 컨테이너가 모두 삭제되니 주의하세요.
포트 충돌 (port is already allocated)
이미 같은 포트를 다른 프로그램이나 컨테이너가 쓰고 있다는 뜻입니다. -p 8081:80처럼 왼쪽(내 PC 쪽) 포트 번호를 바꿔서 다시 실행하세요.
Hyper-V와 VMware/VirtualBox 동시 사용 충돌
WSL2 기반 Docker는 내부적으로 Hyper-V 플랫폼을 사용합니다. VMware나 VirtualBox 같은 다른 가상화 프로그램과 동시에 실행하면 둘 다 느려지거나 멈출 수 있습니다. 가능하면 한 번에 하나만 켜서 쓰세요.
디스크 용량이 계속 늘어날 때
사용하지 않는 이미지·컨테이너·캐시가 쌓여서입니다. 아래 명령으로 한 번에 정리할 수 있습니다.
docker system prune -a주의: 이 명령은 현재 실행 중이지 않은 모든 컨테이너와 사용하지 않는 이미지를 삭제합니다. 삭제 전 꼭 docker ps -a로 확인하세요.
6. Docker Desktop vs Podman Desktop 비교
회사에서 상업적 라이선스 이슈로 Docker Desktop 대신 대안을 찾는 경우가 있어 비교표로 정리했습니다.
| 항목 | Docker Desktop | Podman Desktop |
|---|---|---|
| 무료 여부 | 개인·소규모(250인 미만, 매출 1천만 달러 미만) 무료, 그 외 유료 | 완전 무료(오픈소스) |
| 데몬 구조 | 중앙 데몬(백그라운드 서비스) 필요 | 데몬 없이 실행(rootless 기본 지원) |
| 명령어 호환성 | docker 명령 | podman 명령, docker 별칭 설정 가능 |
| docker-compose | 기본 내장 | podman compose로 호환 지원 |
| 윈도우 설치 난이도 | 쉬움(설치 파일 하나) | 약간 더 설정 필요(WSL2 수동 연동) |
| 추천 대상 | 입문자, 개인 개발자 | 기업 환경, 라이선스 민감한 조직 |
개인 학습·사이드 프로젝트 목적이라면 Docker Desktop으로 시작하는 것을 추천합니다. 자료와 커뮤니티가 압도적으로 많아 막혔을 때 검색이 쉽습니다.
7. FAQ
Q. Docker Desktop이 유료인가요? 개인 사용자, 교육 목적, 비영리 오픈소스 프로젝트, 그리고 직원 250명 미만이면서 연 매출 1천만 달러 미만인 소규모 기업은 무료입니다. 그 외 기업 환경에서는 유료 구독이 필요합니다.
Q. Mac이나 리눅스에서도 설치 방법이 같나요? 설치 파일만 다르고 사용법(명령어, GUI)은 거의 동일합니다. Mac은 Apple Silicon/Intel 버전을 구분해서 받아야 하고, 리눅스는 WSL2 단계 없이 바로 데몬이 설치됩니다.
Q. 컨테이너와 가상머신(VM)은 뭐가 다른가요? 가상머신은 운영체제 전체를 통째로 가상화하지만, 컨테이너는 운영체제 커널을 호스트와 공유하면서 프로세스만 격리합니다. 그래서 컨테이너가 훨씬 가볍고 시작도 빠릅니다.
Q. 회사 사내망(프록시) 환경에서 이미지를 못 받아와요. Docker Desktop Settings → Resources → Proxies에서 사내 프록시 주소를 입력하면 됩니다. 사내 IT팀에 프록시 주소를 문의하세요.
Q. 용량을 많이 차지하는데 완전히 지우려면?
docker system prune -a --volumes로 이미지·컨테이너·볼륨까지 전부 정리할 수 있습니다. Docker Desktop 자체를 지우려면 윈도우 “앱 및 기능”에서 제거하면 WSL2 배포판도 함께 정리됩니다.
8. 핵심 요약
- 윈도우에 도커를 쓰려면 WSL2 설치 + 가상화 활성화가 선행되어야 합니다.
- 공식 사이트에서 Docker Desktop을 받아 설치하면 WSL2 연동이 자동으로 됩니다.
- 설치 확인은
docker run hello-world한 줄이면 충분합니다. - 대부분의 오류는 WSL2 커널 업데이트나 BIOS 가상화 설정으로 해결됩니다.
- 용량이 늘어난다면
docker system prune -a로 주기적으로 정리하세요. - 라이선스가 민감한 기업 환경이라면 Podman Desktop도 대안으로 고려할 수 있습니다.
궁금한 점이 있다면 댓글로 남겨주세요. 다음에도 실제로 도움이 되는 IT 하우투로 찾아오겠습니다!