Docker Desktop brings the full Docker experience to Windows 11: containers, images, Docker Compose, and a visual dashboard, all running on top of WSL 2. Whether you are learning containers, building web apps, or setting up a local development environment, this guide walks you through the entire installation, from checking your system to running your first container.

By the end of this tutorial you will have Docker Desktop installed, verified, and ready to run containers on Windows 11, plus fixes for the most common setup errors.

Prerequisites

  • Windows 11 64-bit (Home, Pro, or Enterprise). Docker Desktop works on all three editions when you use the WSL 2 backend.
  • 4 GB of RAM minimum (8 GB or more recommended if you plan to run databases or several containers at once).
  • Hardware virtualization enabled in your BIOS/UEFI (Intel VT-x or AMD-V). WSL 2 will not work without it.
  • An administrator account to install software and enable Windows features.
  • An internet connection to download the installer and pull your first test image.

Step 1: Check That Virtualization Is Enabled

WSL 2, the engine Docker Desktop uses on Windows 11, needs hardware virtualization. Check it before you install anything else.

Press Ctrl + Shift + Esc to open Task Manager, go to the Performance tab, and click CPU. Look at the bottom-right of the panel: it should say Virtualization: Enabled.

If it says Disabled, restart your computer, enter the BIOS/UEFI setup (usually by pressing Del, F2, or F10 during boot), and enable Intel Virtualization Technology (VT-x) or AMD-V / SVM Mode, usually found under Advanced, CPU Configuration, or Security settings. Save and exit, then check Task Manager again.

Step 2: Install or Update WSL 2

Docker Desktop on Windows 11 runs its Linux engine inside WSL 2 (Windows Subsystem for Linux). Windows 11 ships with WSL available, but you need to make sure it is installed and up to date.

Open PowerShell or Windows Terminal as Administrator (right-click the Start button and choose Terminal (Admin)) and run:

wsl --install

This command installs WSL 2 and the default Ubuntu distribution, and enables the required Windows features (Virtual Machine Platform and Windows Subsystem for Linux). If WSL is already installed, the command simply reports that it is up to date. Restart your computer when prompted.

After the restart, update the WSL kernel and set WSL 2 as the default version:

wsl --update
wsl --set-default-version 2

The first command updates the Linux kernel that WSL 2 uses; the second makes sure any new Linux distribution you install defaults to WSL 2 rather than the older WSL 1. You can confirm your setup with:

wsl --status
wsl --list --verbose

The output should show Default Version: 2 and list Ubuntu (or your chosen distribution) with version 2.

Step 3: Download Docker Desktop

Always download Docker Desktop from the official source. Go to https://www.docker.com/products/docker-desktop/ and click Download for Windows. The download is a file called Docker Desktop Installer.exe, roughly 600 MB.

Docker Desktop is free for personal use, education, and small businesses under the Docker Personal subscription. Larger companies need a paid subscription, but installation and local development work the same either way.

Step 4: Run the Installer

Double-click Docker Desktop Installer.exe. When the installer asks which backend to use, make sure Use WSL 2 instead of Hyper-V is checked. This is the recommended backend on Windows 11: it starts faster, uses less memory, and integrates cleanly with your WSL distributions.

Click OK and let the installer finish. It installs Docker Desktop, adds the Docker command-line tools to your PATH, and creates a docker-users group for permission management. When the installer asks you to log out or restart, do so: the group membership and PATH changes only take effect after a fresh sign-in.

Do not skip the restart. Most "docker command not found" and permission errors after installation are simply a missing sign-out/sign-in after the installer added your account to the docker-users group.

Step 5: Start Docker Desktop and Complete Setup

Launch Docker Desktop from the Start menu. On first launch it shows the Docker Subscription Service Agreement: accept it to continue. You can sign in with a Docker Hub account or choose Continue without signing in if you just want to work locally; signing in is only required to push images to Docker Hub or use Docker Scout features.

Docker Desktop takes a minute or two on first start while it initializes the WSL 2 engine. Wait until the status in the bottom-left of the dashboard turns green and says Engine running. The dashboard also shows a short welcome walkthrough with a sample container you can run if you like.

Step 6: Verify the Installation

Open a new PowerShell or Windows Terminal window (after the restart, so the updated PATH is loaded) and run:

docker --version
docker compose version

You should see version numbers for both the Docker client and Compose, for example Docker version 28.x and Docker Compose version v2.x. Now run the classic smoke test:

docker run hello-world

Docker pulls the tiny hello-world image from Docker Hub and runs it. If you see the message "Hello from Docker! This message shows that your installation appears to be working correctly.", everything is set up. You can also check that the engine is healthy with:

docker ps
docker images

The first command lists running containers (empty for now, which is normal), and the second lists your downloaded images, including hello-world.

Step 7: Run Your First Real Container (Optional but Recommended)

To prove the setup is genuinely useful, run an Nginx web server in a container and open it in your browser:

docker run -d -p 8080:80 --name my-nginx nginx

This downloads the official Nginx image, starts it in the background (-d), and maps port 8080 on your Windows machine to port 80 inside the container (-p 8080:80). Open http://localhost:8080 in your browser and you should see the Nginx welcome page. Stop and remove the container when you are done:

docker stop my-nginx
docker rm my-nginx

Verify It Worked

  • Docker Desktop dashboard shows "Engine running" in green.
  • docker --version prints a version number with no errors.
  • docker run hello-world prints the success message.
  • http://localhost:8080 served the Nginx welcome page while the test container was running.

If all four checks pass, Docker Desktop is fully working on your Windows 11 machine.

Common Issues and Fixes

"WSL 2 installation is incomplete" or "WSL 2 requires an update to its kernel component"

Your WSL kernel is out of date. Run wsl --update from an elevated PowerShell, then restart Docker Desktop. If the error persists, install the kernel update package manually from Microsoft (aka.ms/wsl2kernel) and restart.

Docker Desktop is stuck on "Starting" forever

First, check that virtualization is still enabled (Task Manager, Performance, CPU). Then right-click the Docker Desktop tray icon and choose Troubleshoot, then Restart Docker Desktop. If it still hangs, use Clean / Purge data from the same Troubleshoot menu, or Reset to factory defaults — this wipes local images and containers, so export anything important first.

"Hardware assisted virtualization and data execution protection must be enabled in the BIOS"

Virtualization is disabled in your BIOS/UEFI. Reboot into setup, enable Intel VT-x or AMD-V, and also make sure Data Execution Prevention (DEP) is on. Save and exit, then start Docker Desktop again.

"docker: command not found" in the terminal

Your terminal was opened before the installer updated the PATH, or your account has not picked up the docker-users group yet. Sign out of Windows and sign back in (a full restart is safest), then open a fresh terminal window.

Containers cannot reach the internet or pull images

Corporate VPNs and some firewalls block Docker's traffic. Try disconnecting the VPN for the first pull, or in Docker Desktop go to Settings, Resources, Network and switch the DNS server to 8.8.8.8. Restart Docker Desktop after changing network settings.

Conclusion

Installing Docker Desktop on Windows 11 comes down to three things: enabling virtualization, setting up WSL 2, and running the official installer with the WSL 2 backend selected. Once docker run hello-world prints its success message, you have a complete container platform on your desktop, ready for development, testing, and learning Docker and Kubernetes.

Need help setting up Docker, containers, or a full development environment on your servers? XpertBees helps businesses plan, install, and manage their infrastructure, from a single VPS to a complete container platform. Get in touch through xpertbees.in and we will take it from there.