How to Install and Configure Docker Desktop on Windows 10 Home (Enable Hyper‑V, Registry Tweaks, and Mirror Settings)

1. Verify virtualization support

Open Task Manager → Performance and confirm that Virtualization is enabled. If not, restart, enter BIOS, and enable virtualization.

2. Install Hyper‑V

Create a text file with the following commands, rename it to .cmd, and run it as administrator:

pushd "%~dp0"
 dir /b %SystemRoot%\servicing\Packages\*Hyper-V*.mum >hyper-v.txt
 for /f %%i in ('findstr /i . hyper-v.txt 2^>nul') do dism /online /norestart /add-package:"%SystemRoot%\servicing\Packages\%%i"
 del hyper-v.txt
 Dism /online /enable-feature /featurename:Microsoft-Hyper-V-All /LimitAccess /ALL

After the script finishes, follow the prompts to reboot, then enable Hyper‑V in Control Panel → Programs → Turn Windows features on or off .

3. Enable additional Windows features

Check the boxes for "Windows Subsystem for Linux", "Virtual Machine Platform", and "Windows Hypervisor Platform" and enable them.

4. Spoof Windows edition

Open an elevated command prompt and run:

REG ADD "HKEY_LOCAL_MACHINE\software\Microsoft\Windows NT\CurrentVersion" /v EditionId /t REG_EXPAND_SZ /d Professional /F

This changes the registry value to "Professional", allowing Docker Desktop to run on Windows 10 Home.

5. Install Docker Desktop

Download the installer from https://www.docker.com/products/docker-desktop/ and launch it. During setup uncheck the option "Use WSL 2 instead of Hyper‑V (recommended)". Leaving this option enabled on Windows 10 Home causes Docker Engine to remain stopped with no clear error.

6. Verify installation

Open a command prompt and run: docker version The command should display client and server version information.

7. Use the CLI for image searches

Because the UI cannot access the internet behind a firewall, search images via the command line, e.g.:

docker search jenkins

8. Configure registry mirrors

Edit the Docker Engine JSON configuration file (usually \ProgramData\Docker\config\daemon.json) and add a "registry-mirrors" array:

{
  "registry-mirrors": [
    "https://hub-mirror.c.163.com",
    "https://docker.mirrors.ustc.edu.cn",
    "https://registry.docker-cn.com",
    "https://reg-mirror.qiniu.com"
  ]
}

Ensure the JSON syntax is valid (add a preceding comma if inserting into an existing file) and restart Docker Desktop. After the mirror configuration, image pulls complete without timeout errors.

9. Example of successful pull

With the mirrors configured, pulling an image succeeds without the previous timeout failures.