[Solved] Docker Desktop is Unable to Detect a Hypervisor Issue

Learn how to troubleshoot and resolve the issue of Docker Desktop failing to detect a Hypervisor. Follow our step-by-step guide to overcome common obstacles and ensure smooth containerization with Docker.

By @Zelia Last Updated August 9, 2024

Install error: Docker Desktop is unable to detect a Hypervisor

Docker Desktop offers a variety of features for managing virtualized environments. However, when you install or use Docker Desktop you may get and error saying "Docker Desktop is unable to detect a Hypervisor: Hardware-assisted virtualization and data execution protection must be enabled in the BOIS". 

Don't worry, you can keep on reading, we will explain why this issue occurs and help you solve this problem.

Common Causes of can't detect hypervisor

The error can happen for several reasons:

► Hyper-V is not enabled in Windows: On Windows, Docker Desktop requires Hyper-V or WSL 2 (Windows Subsystem for Linux 2) to run containers. If Hyper-V is not enabled, Docker Desktop cannot create the necessary virtual machine.

Virutalization disabled in BIOS: Virtualization technology (VT-x/AMD-V) may be disabled in your system's BIOS/UEFI settings, which prevents Docker Desktop from accessing the hypervisor.

Incompatible or corrupted Hypervisor software: If there is an issue with the Hyper-V or any other hypervisor software installed on your system, Docker Desktop may be unable to detect the hypervisor.

Virtualization software conflicts: Other virtualization software may conflict with Docker Desktop’s use of Hyper-V or other virtualization.

How to fix the docker desktop is unable to detect a hypervisor

Here are some solutions you can try to resolve the "hypervisor not detect" problem. Before getting started, you can backup your VMs in case of any data loss. 

AOMEI Cyber Backup
Free, Easy, Centralized VM Backup Solution
  • Free VMware & Hyper-V VMs protection.
  • Agentless and automatic backup virtual machines.
  • Fast VM recovery with minimal downtime.
100% Secure

Solution 1. Enable virtualization technology in BIOS

Step 1. Restart your computer. When you see the logo, press the boot key (The boot key depends on the computer brand. Usually boot key is "F2", "Delete", or "ESC")

Step 2. Find the Virtualization setting in the Security tab. Usually, the virtualization setting is labeled as "Intel VT-X" or "AMD-V".

Step 3. Save the changes and exit the BIOS, restart your computer.

Solution 2. Ensure Hyper-V is properly enabled in Windows

If your Windows hypervisor is not present and can be detected by desktop, you can check if the Hyper-V is enabled in Windows.  Follow the steps below to enable Hyper-V in Windows.

Step 1. Click the Windows icon on the left-down corner and open Control Panel. Or just type the control panel on the search box and open the search outcome.

Step 2. Choose "Programs and Features" on the Control Panel. Click "Turn Windows features on or off" on the left side of the window.

Step 3. Make sure the Hyper-V option is selected. And click "ok" to apply the changes. Then restart your system.

Solution 3. Disable conflicting virtualization software

Identify other virtualization software running on your system. you can temporarily disable or uninstall the software. Then restart the system and check if docker desktop can detect the hypervisor.

Solution 4. Verify compatibility with supported Hypervisors

A corrupted or incompatible hypervisor software can cause Docker Desktop can't detect the hypervisor.

So you can reinstall your Hyper-V or WSL 2. And ensure other virtualization software such as VMware or Virtual Box is either compatible or not conflicting with Docker Desktop.

If the current Hypervisor is causing compatibility problems, consider switching to a different one

Potential Workarounds

If all the above solutions can help you, you can try the following ways.

1. Using Docker Toolbox instead of Docker Desktop:

  • Docker Toolbox is an alternative to Docker Desktop for systems that don't meet the hardware requirements
  • It uses VirtualBox as the default Hypervisor and may bypass the detection issue

2. Running Docker Desktop in a virtual machine:

  • Create a virtual machine using a compatible Hypervisor
  • Install Docker Desktop within the virtual machine
  • This can help overcome detection issues on the host machine

Conclusion

Docker Desktop is unable to detect a hypervisor usually indicates a problem with your system's ability to provide the necessary virtualized environment that Docker Desktop relies on. 

There could be several reasons behind it, such as insufficient virtualization support in the BIOS, incompatibility with certain Hypervisors, and conflicts with other virtualization software. We provided troubleshooting steps to help you resolve the issue, including checking BIOS settings, enabling Hyper-V (for Windows users), verifying compatibility with supported Hypervisors and disabling conflicting virtualization software.

Remember to backup your virtual machines in case of data loss due to any misoperation. AOMEI Cyber Backup is a great backup solution for protecting VMware and Hyper-V VMs from data loss. It can enable users to easily backup all VMs from a single console and quickly restore.