Technical Anshu
Tutorials Blog
🐳 Docker Fix

Docker Desktop Will Not Start on Windows the Fix Ladder

Docker Desktop stuck on 'starting' is not one problem - it is five problems wearing the same coat. This ladder checks them in the order of how often each one is guilty, from the BIOS switch to the Windows group most people never hear of.

✍️ Technical Anshu🪟 Windows 10 / 11⏱️ 8 minute read
🎥 Watch the full install in the video - WSL 2 setup and the first container, step by step

Resist the urge to reinstall. A stuck Docker Desktop almost always traces to one rung of this ladder, and reinstalling fixes none of them - it just costs you twenty minutes and your settings. Work from rung 1 down, test after each, and stop when it starts. Every rung here is a documented requirement of the WSL 2 backend, not folklore.

The ladder - check in this order, stop when Docker starts
1. BIOS virtualisation - Task Manager says Enabled?
2. Windows features - WSL and Virtual Machine Platform on?
3. WSL itself - distro finished, VERSION 2, kernel updated?
4. Services - Docker Desktop Service and WSL Service running?
5. Your account - in docker-users, and signed in since?
6. Only now - repair or reinstall Docker Desktop
Six rungs, in guilt order - most stuck installs surrender at rung 1, 3 or 5
1

Rung 1 and 2 - Virtualisation and Windows Features

  1. Open Task Manager, Performance, CPU. If Virtualization says Disabled, enter your BIOS or UEFI setup and enable Intel VT-x or AMD SVM. No Windows setting can substitute for this switch - it is the single most common cause
  2. A Windows update or a cleanup tool can also turn features off. In 'Turn Windows features on or off', confirm Windows Subsystem for Linux and Virtual Machine Platform are both ticked, then restart if you changed either
2

Rung 3 - WSL Itself Must Be Healthy

Docker's engine lives inside WSL 2, so a sick WSL means a stuck Docker.

  1. Run wsl --status - it should answer cleanly with a default version of 2
  2. Run wsl -l -v - your distro must show VERSION 2, and opening the distro by name should reach a Linux prompt. A distro that never finished its first run (no Linux user created) blocks everything behind it
  3. Run wsl --update to refresh the kernel - the 'WSL 2 installation is incomplete' error is precisely this rung, and the fix is the kernel update package or wsl --update, not a Docker reinstall
  4. If WSL itself is tangled, wsl --shutdown, wait ten seconds, and start Docker again before trying anything harsher
3

Rung 4 and 5 - Services and the docker-users Group

  1. Open services.msc. Docker Desktop Service should exist and be able to start; the WSL Service (LxssManager) should be running. A service stuck stopped after an unclean shutdown often just needs a manual Start
  2. Run net localgroup docker-users in a terminal - your account must be listed. Docker Desktop adds you at install time, but a failed install or a domain policy can leave you out. If you are missing, an administrator can add you with net localgroup docker-users YourName /add
  3. Then sign out of Windows completely and back in. Group membership is only picked up at sign-in - skipping this is why 'I added myself and it still fails' happens

The classic permission error - access denied on the Docker pipe - is this rung introducing itself.

4

Rung 6 - Repair, Reinstall, and the Honest Last Resorts

Only with the ladder below you clean: reinstall Docker Desktop from docker.com (your images and containers live in the WSL data, and a normal reinstall keeps them - but export anything irreplaceable first, because 'normally' is doing real work in that sentence).

Two honest extras: corporate antivirus and endpoint tools do occasionally block the engine's virtual network - if this is an office PC and every rung passes, that is an IT ticket with real evidence behind it, not a you problem. And if Docker ran yesterday and broke today, ask what changed: Windows updates and WSL kernel updates are the usual suspects, and rung 3 fixes most of those.

🔴 Do not 'fix' a stuck Docker by randomly deleting the WSL data folders or the Docker vhdx files you find online. Those files hold every image and volume you own. The ladder above solves the start problem; deletion solves nothing and converts a ten-minute fix into total data loss.

🎥 Watch the Complete Process in the Video

If your Docker has never started at all, go back to the video install and this ladder together - screen in one hand, checklist in the other.

▶️ Watch Full Video
❓ Frequently Asked Questions

Docker Desktop says WSL 2 installation is incomplete. What does it want?

The WSL 2 kernel is missing or too old. Run wsl --update from an administrator terminal, or install Microsoft's WSL 2 kernel update package, restart, and start Docker again. It is a Windows-side gap, not a Docker fault, and reinstalling Docker will not close it.

I get a permission or access denied error about the Docker pipe. Why?

Your account is not active in the docker-users group, or you have not signed out since being added. Check membership with net localgroup docker-users, get an admin to add you if needed, then sign fully out of Windows and back in - a lock or sleep is not enough.

Docker worked yesterday and will not start today. What changed?

Usually a Windows update, a WSL kernel change, or an unclean shutdown that left services stopped. Run wsl --update, check services.msc for the Docker Desktop Service and WSL Service, and try wsl --shutdown followed by a fresh Docker start before considering a reinstall.

This guide is based on the Technical Anshu Docker on WSL 2 video • Stuck on any step? Ask in the video comments — you will get a reply there 🙏