Windows에 Docker Desktop 설치하기
Windows에 Docker Desktop 설치하기
이 페이지는 Windows에서의 Docker Desktop 다운로드 링크, 시스템 요구 사항, 단계별 설치 지침을 제공해요.
본문
Docker Desktop 약관: 더 큰 기업(직원 250명 초과 또는 연간 매출 1천만 달러 초과)에서 Docker Desktop을 상업적으로 사용하려면 유료 구독이 필요해요.
- Windows용 Docker Desktop - x86_64
- Microsoft Store의 Windows용 Docker Desktop - x86_64
- Windows용 Docker Desktop - Arm (조기 액세스)
체크섬은 릴리스 노트를 참고하세요.
설치 모드
Docker Desktop은 두 가지 설치 모드를 지원해요. 대부분의 사용자에게 per-user 설치가 권장되고 설치 프로그램에서 기본 선택돼요. 설치/업데이트에 관리자 권한이 필요 없고, 사용하는 WSL 2 백엔드가 대다수 Docker Desktop 사용자의 요구를 충족해요.
| Per-user (권장) | All users | |
|---|---|---|
| 설치 위치 | %LOCALAPPDATA%\Programs\DockerDesktop |
C:\Program Files\Docker\Docker |
| 레지스트리 키 | Current User (HKCU) | Local Machine (HKLM) |
| 설치에 관리자 권한 | 필요 없음 | 필요 |
| 업데이트에 관리자 권한 | 필요 없음 | 필요 |
| Linux 컨테이너 백엔드 | WSL 2 또는 Docker VMM | WSL 2, Hyper-V, Docker VMM |
| Windows 컨테이너 | 지원 안 함 | 지원 |
| 보안 | 더 작은 공격 표면; privileged 시스템 서비스 미설치 | privileged 시스템 서비스 필요; 호스트 리소스에 더 넓은 접근 |
자세한 내용은 Windows 권한 요구 사항 이해하기를 참고하세요.
시스템 요구 사항
어떤 백엔드를 써야 하나요? Windows용 Docker Desktop은 WSL 2, Hyper-V, Docker VMM(Beta) 세 가지 백엔드를 지원해요. WSL 2가 기본이고 관리자 권한 없이 대부분의 사용자에게 동작해요. Hyper-V는 all-users 설치에서만 사용 가능해요. Docker VMM은 유휴 메모리를 회수하고 파일 I/O를 개선하는 컨테이너 최적화 하이퍼바이저예요.
WSL 2 백엔드, x86_64:
- WSL 버전 2.1.5 이상. 버전 확인은 WSL: 확인 및 설정 참고.
- Enhanced Container Isolation을 쓰려면 WSL 버전 2.6 이상. ECI가 최소 Linux 커널 6.3.0에 의존하고 WSL 2.6+는 커널 6.6을 번들 제공하기 때문.
- Windows 10 64비트: Enterprise, Pro, Education 22H2(build 19045).
- Windows 11 64비트: Enterprise, Pro, Education 23H2(build 22631) 이상.
- Windows Server 서비스(LanmanServer)가 활성화되고 시작 모드가 Automatic이어야 해요.
- Windows에서 WSL 2 기능 활성화. 자세한 지침은 Microsoft 문서 참고.
- WSL 2를 Windows 10/11에서 실행하기 위한 하드웨어 요구: SLAT(Second Level Address Translation) 있는 64비트 프로세서, 8GB RAM, BIOS/UEFI에서 하드웨어 가상화 활성화.
참고: Docker는 Microsoft 서비스 타임라인 안에 있는 Windows 버전에서만 Docker Desktop을 지원해요. Windows Server 2019/2022 같은 서버 버전에서는 지원되지 않아요. Windows 컨테이너를 실행하려면 Windows 10/11 Professional 또는 Enterprise 에디션이 필요해요. Windows Home/Education 에디션은 Linux 컨테이너만 실행할 수 있어요.
Hyper-V 백엔드, x86_64: Windows 10/11 Enterprise, Pro, Education 버전, LanmanServer 자동 시작, Hyper-V와 Containers Windows 기능 활성화, SLAT 있는 64비트 프로세서, 8GB RAM, BIOS/UEFI에서 하드웨어 가상화 활성화.
WSL 2 백엔드, Arm (조기 액세스): Windows 컨테이너는 지원되지 않아요.
Docker Desktop으로 만든 컨테이너와 이미지는 설치된 머신의 모든 사용자 계정 간에 공유돼요. 모든 Windows 계정이 같은 VM으로 컨테이너를 빌드하고 실행하기 때문이에요. 단, WSL 2 백엔드를 쓸 때는 사용자 계정 간 컨테이너/이미지를 공유할 수 없어요. Docker Business 고객은 VMware ESXi나 Azure VM 안에서 Docker Desktop을 실행할 수 있고, 먼저 하이퍼바이저에서 중첩 가상화를 활성화해야 해요.
Windows에 Docker Desktop 설치하기
대화형으로 설치하기
- 페이지 상단의 다운로드 버튼이나 릴리스 노트에서 설치 프로그램을 다운로드해요.
Docker Desktop Installer.exe를 더블클릭해 실행해요. 설치 프로그램이 선호하는 설치 모드를 물어봐요. per-user는%LOCALAPPDATA%\Programs\DockerDesktop에 설치되고 관리자 권한이 필요 없어요. all users를 선택하면 elevation을 요구해요. 나중에 설치 모드를 바꾸려면 제거 후 재설치해야 해요.- 구성 페이지에서 백엔드를 선택해요: WSL 2면 "Use WSL 2 instead of Hyper-V"를 선택하거나, Hyper-V면 선택하지 않고 둬요. 설치 후 Settings > General에서 Docker VMM으로 전환할 수 있어요. 한 백엔드만 지원하는 시스템에서는 사용 가능한 옵션을 자동 선택해요.
- 설치 마법사의 지침을 따라 설치 프로그램을 승인하고 설치를 진행해요.
- 설치가 성공하면 Close 를 선택해 완료해요.
- Docker Desktop을 시작해요.
명령줄에서 설치하기 — (명령줄 설치 지침)