[Docker] Docker Desktop - Unexpected WSL error in Windows11 Home

1. Docker 설치 후 아래와 같은 오류 메시지 발생

provisioning docker WSL distros: ensuring main distro is deployed: deploying "docker-desktop": importing WSL distro "WSL2는 현재 컴퓨터 구성에서 지원되지 않습니다.\r\n\"가상 머신 플랫폼\" 선택적 구성 요소를 사용하도록 설정하고 BIOS에서 가상화가 사용하도록 설정되어 있는지 확인하세요.\r\n실행하여 \"가상 머신 플랫폼\"을 사용하도록 설정: wsl.exe --install --no-distribution\r\n자세한 내용은 https://aka.ms/enablevirtualization 참조하세요.\r\nError code: Wsl/Service/RegisterDistro/CreateVm/HCS/HCS_E_HYPERV_NOT_INSTALLED\r\n" output="docker-desktop": exit code: 4294967295: running WSL command wsl.exe C:\WINDOWS\System32\wsl.exe --import docker-desktop \AppData\Local\Docker\wsl\distro C:\Program Files\Docker\Docker\resources\wsl\wsl-bootstrap.tar --version 2: WSL2는 현재 컴퓨터 구성에서 지원되지 않습니다.
"가상 머신 플랫폼" 선택적 구성 요소를 사용하도록 설정하고 BIOS에서 가상화가 사용하도록 설정되어 있는지 확인하세요.
실행하여 "가상 머신 플랫폼"을 사용하도록 설정: wsl.exe --install --no-distribution
자세한 내용은 https://aka.ms/enablevirtualization 참조하세요.
Error code: Wsl/Service/RegisterDistro/CreateVm/HCS/HCS_E_HYPERV_NOT_INSTALLED
: exit status 0xffffffff
checking if isocache exists: CreateFile \\wsl$\docker-desktop-data\isocache\: The network name cannot be found.

2. wsl 최신버전 업데이트 및 버전 확인

Windows PowerShell을 관리자 권한으로 실행한다.

// wsl이 없다면 인스톨 필요
wsl --install

// update
wsl --update

// checking version
wsl --version

 

3. wsl2로 defalut version 설정

// WSL 2 버전이 기본값으로 설정되어 있는지 확인
wsl -l -v

// WSL 2 버즌을 기본으로 변경
wsl --set-default-version 2

 

4. Hyper-v Feature 활성화

bcdedit /set hypervisorlaunchtype auto

 

Windows 기능 켜기 / 끄기에서 확인한다.

 

Docker desktop 삭제 후 재설치하면 끄읕

5. 참고

https://k21academy.com/docker-kubernetes/docker-desktop-unexpected-wsl-error-solved/