들어가며
Docker Desktop을 설치하고 실행했더니 다음과 같은 에러를 마주쳤습니다.
Docker Desktop is unable to detect a Hypervisor
이번 시간에는 이 에러를 해결하는 방법에 대해 알아보겠습니다.
가상화 설정
Docker를 사용하기 위해서는 가상화 설정이 필요합니다.
https://docs.docker.com/desktop/troubleshoot/topics/#virtualization
Windows Home
Windows Home의 경우 WSL2가 필요합니다.
- Windows Features에서 다음 옵션 체크
Virtual Machine Platform
Windows Subsystem for Linux
이후 재부팅이 필요합니다. - 바이오스에서 가상화 설정 사용
- WSL 설치
WSL 설치를 위해 powershell에서 아래 명령어를 실행해 줍니다.
wsl --install
wsl --set-default-version 2
Windows Pro / Enterprise
Windows Pro / Enterprise의 경우 Hyper-V를 이용할 수도 있습니다.
- Windows Features에서 다음 옵션 체크
Hyper-V
이후 재부팅이 필요합니다. - 바이오스에서 가상화 설정 사용
저의 경우, 모든 설정을 마쳤음에도 에러가 계속됐는데요.
1번의 옵션 모두 체크 해제 -> 재시작 -> 옵션 다시 체크 -> 재시작
위 과정을 통해 에러가 해결됐습니다.
만약 위 설정을 다 마쳤음에도 Docker Desktop 시작 시 이슈가 계속된다면, Hypervisor가 설치됐지만 Windows 시작 시 실행이 되지 않아서일 수도 있습니다.
아래 글을 참고해주세요.
https://docs.docker.com/desktop/troubleshoot/topics/#hypervisor-enabled-at-windows-startup
Docker가 정상적으로 실행이 되고 로그인을 마치면, 아래와 같은 화면을 보실 수 있습니다.
마치며
이렇게 Docker Desktop is unable to detect a Hypervisor 에러를 해결해 봤습니다.
Docker를 이용하시는데 도움이 되셨으면 좋겠습니다.
지적이나 다른 의견은 언제나 환영합니다 :D
감사합니다.
References
https://docs.docker.com/desktop/troubleshoot/topics/#hyper-v
https://www.virtualmetric.com/blog/how-to-enable-hardware-virtualization