Docker Desktop 실행 안 됨 해결: WSL 2·가상화(Virtualization) 설정 점검 순서 (Windows 11 기준)

Docker Desktop을 설치했는데 실행이 안 되거나 "Docker Desktop - Unexpected WSL error"처럼 낯선 오류가 뜨는 경우가 있습니다. 포트 충돌처럼 컨테이너 실행 중 나는 오류와 달리, 이번 글은 Docker Desktop 자체가 아예 켜지지 않는 설치·시작 단계 문제를 다룹니다. Docker와 Microsoft 공식 문서를 기준으로 WSL 2와 가상화 설정을 점검하는 순서를 정리했습니다.

빠른 결론

1. "Docker Desktop - Unexpected WSL error"(오류 코드 HCS_E_HYPERV_NOT_INSTALLED 포함)는 BIOS 가상화 비활성화나 WSL 2 구성 요소 누락이 주 원인이라고 Docker 공식 문서에 명시되어 있습니다.
2. Windows 11 Home 에디션은 WSL 2 백엔드만 지원하며, Pro 이상에서는 Hyper-V 백엔드도 선택할 수 있습니다.
3. 작업 관리자에서 가상화 사용 여부를 확인하고 wsl --update 명령을 실행하는 것이 가장 먼저 시도할 점검입니다.

기준일

2026년 8월 25일, Docker 공식 문서(Install Docker Desktop on Windows, Troubleshoot topics)와 Microsoft 공식 WSL 설치 문서를 기준으로 확인했습니다. Docker Desktop 최신 버전 기준이며 사내 정책으로 관리되는 PC는 일부 절차가 제한될 수 있습니다.

시스템 요구사항 체크리스트

항목	확인 방법
Windows 버전	Windows 11 Enterprise·Pro·Education 23H2(빌드 22631) 이상, 또는 Windows 10 22H2(빌드 19045)
WSL 버전	PowerShell에서 wsl --version 입력, 2.1.5 이상 권장
가상화 지원	작업 관리자 → 성능 탭 → CPU → "가상화" 항목이 "사용"인지 확인
BIOS 가상화 설정	제조사별 BIOS·UEFI에서 Intel VT-x 또는 AMD-V 활성화 여부
Windows 기능	"Virtual Machine Platform", "Linux용 Windows 하위 시스템" 켜짐 여부

해결 순서

1. 작업 관리자(Ctrl+Shift+Esc) → [성능] 탭 → 왼쪽 [CPU] 선택 → 하단 "가상화" 항목이 "사용"으로 표시되는지 확인합니다. "사용 안 함"이면 BIOS·UEFI 진입(재부팅 중 제조사별 Del·F2·F10 등)에서 가상화 옵션을 켜야 합니다.
2. PowerShell을 관리자 권한으로 열고 wsl --version을 입력해 버전을 확인합니다. 버전이 표시되지 않거나 2.1.5 미만이면 wsl --update를 실행한 뒤 재부팅합니다.
3. 시작 메뉴에서 "Windows 기능 켜기/끄기"를 검색해 실행하고, "Virtual Machine Platform"과 "Linux용 Windows 하위 시스템" 항목이 체크되어 있는지 확인합니다. 방금 체크했다면 재부팅이 필요합니다.
4. wsl -l -v 명령으로 설치된 배포판 목록과 WSL 버전(1 또는 2)을 확인하고, wsl -d docker-desktop echo WSL 2 is working 명령이 정상적으로 출력되는지 확인합니다.
5. 위 과정을 마쳐도 같은 오류가 반복되면 관리자 권한 명령 프롬프트에서 bcdedit /set hypervisorlaunchtype auto 를 입력한 뒤 재부팅합니다. 일부 구버전 가상화 도구나 안드로이드 에뮬레이터가 설치 과정에서 하이퍼바이저를 꺼두는 경우가 있습니다.

주의사항

BIOS 진입 방법과 가상화 옵션 이름은 제조사·모델마다 달라 PC·노트북 제조사의 공식 지원 문서를 함께 확인하는 것이 안전합니다. 회사·학교 지급 PC는 BIOS 접근이나 Windows 기능 변경이 관리자 권한으로 제한되어 있을 수 있습니다. Windows Home 에디션은 Hyper-V 백엔드를 선택할 수 없고 WSL 2 백엔드만 지원한다는 점도 설치 전 확인이 필요합니다.

해결되지 않을 때 추가 점검

Docker 공식 문서는 일부 백신 소프트웨어가 Hyper-V와 충돌해 Windows 업데이트 직후 Docker Desktop이 시작되지 않는 사례를 언급합니다. 백신 예외 등록이나 일시 비활성화 후 재시도해 볼 수 있습니다. 그래도 안 되면 Docker Desktop을 완전히 제거한 뒤 최신 설치 파일로 재설치하거나, Docker 공식 GitHub 이슈 트래커에서 동일 오류 코드를 검색해 최신 알려진 이슈인지 확인하시기 바랍니다.

FAQ

1. Windows Home 에디션에서도 Docker Desktop을 쓸 수 있나요?
가능합니다. WSL 2 백엔드를 사용하면 되며, 다만 Windows 컨테이너와 Hyper-V 백엔드는 Home 에디션에서 지원되지 않습니다.
2. 가상화를 켜면 다른 프로그램에 문제가 생기나요?
대부분의 경우 문제가 없지만, 일부 구버전 가상머신 소프트웨어나 특정 안티치트를 사용하는 게임은 가상화·Hyper-V 활성화 상태와 충돌한다고 보고된 사례가 있어, 필요할 때만 켜고 평소 쓰지 않는다면 꺼두는 사용자도 있습니다.
3. 포트 충돌 오류와 이 글의 오류는 다른가요?
다릅니다. 포트 충돌(port is already allocated)은 Docker Desktop이 이미 켜진 상태에서 특정 포트를 다른 프로그램이 쓰고 있을 때 나는 오류이고, 이 글은 Docker Desktop 자체가 시작되지 않는 WSL·가상화 단계 문제를 다룹니다. 포트 충돌은 아래 내부 링크를 참고하시기 바랍니다.

내부 링크

Docker 포트 충돌 해결: port is already allocated 원인·Compose 점검 · WSL2 메모리·디스크 용량 과다 사용 줄이기: .wslconfig 설정과 ext4.vhdx 관리 · Git push 인증 실패 해결: GitHub 비밀번호 인증 오류와 PAT(개인 액세스 토큰) 설정

공식 출처

Docker 공식 문서 - Install Docker Desktop on Windows(시스템 요구사항) / Docker 공식 문서 - Troubleshoot(Docker Desktop fails due to Virtualization not working) / Microsoft Learn - Install WSL (2026-08-25 확인)