Docker has become one of the most popular tools for developers who need a consistent environment for building, testing, and deploying applications. With Docker Desktop, Windows users can run Linux and Windows containers from a convenient desktop application without setting up a traditional Linux server.
If you are new to containers, installing Docker Desktop on Windows may seem complicated at first. Fortunately, the process is relatively straightforward when your system meets the required virtualization and Windows Subsystem for Linux (WSL 2) requirements.
In this guide, you’ll learn how to install Docker Desktop on Windows, configure WSL 2, verify that Docker is working correctly, and troubleshoot some of the most common installation problems.
What Is Docker Desktop?
Docker Desktop is a Windows application that provides the tools required to build and run containers locally. It includes Docker Engine, the Docker command-line interface (CLI), and other development features in an integrated environment.
On Windows, Docker Desktop commonly uses WSL 2 (Windows Subsystem for Linux 2) as its backend. WSL 2 provides a Linux kernel and allows Docker to run Linux containers efficiently while remaining integrated with Windows.
Docker Desktop is useful for:
- Web application development
- Software testing
- Local development environments
- Running databases in containers
- DevOps and CI/CD development
- Learning Docker and container technology
- Building applications for cloud deployment
Docker Desktop Windows Requirements
Before installing Docker Desktop, check that your PC meets the current requirements.
Docker currently supports Docker Desktop on supported versions of Windows that remain within Microsoft’s servicing timeline. For the WSL 2 backend, Docker lists Windows 10 64-bit version 22H2 (build 19045) for supported editions and Windows 11 64-bit version 23H2 (build 22631) or later for supported editions. WSL 2 version 2.1.5 or later is required.
Your computer should also have:
- A 64-bit processor with SLAT support
- At least 8 GB of RAM
- Hardware virtualization enabled in BIOS or UEFI
- WSL 2 enabled
- A supported Windows installation
- The Windows Server service enabled and configured to start automatically
If you’re using Windows containers, additional Windows edition and Hyper-V requirements apply. Windows Home and Education editions are limited to Linux containers.
Step 1: Check Your Windows Version
Before installing Docker Desktop, confirm your Windows version.
Press Windows + R, type:
winver
and press Enter.
Alternatively, open:
Settings → System → About
Check your Windows edition and OS build.
If your Windows installation is outdated, install available Windows updates before continuing.
Step 2: Check Hardware Virtualization
Docker Desktop relies on virtualization technology. If virtualization is disabled, Docker may fail to start even if the installation itself succeeds.
You can check virtualization status through Task Manager.
- Press Ctrl + Shift + Esc.
- Select Performance.
- Select CPU.
- Look for Virtualization.
If it says Enabled, you’re ready.
If virtualization is disabled, restart your PC and enter the BIOS or UEFI settings. The exact option depends on your motherboard or processor. It may be called Intel VT-x, Intel Virtualization Technology, AMD-V, or SVM Mode.
Enable virtualization, save your changes, and restart Windows.
Step 3: Install or Update WSL 2
For most Windows users, WSL 2 is the recommended Docker Desktop backend.
Open PowerShell as Administrator and run:
wsl --install
If WSL is already installed, update it with:
wsl --update
You can check the installed WSL version using:
wsl --version
Docker recommends keeping WSL updated, and Docker Desktop requires at least WSL 2.1.5 for the WSL 2 backend.
You can also check your installed Linux distributions with:
wsl --list --verbose
A distribution configured for WSL 2 should show 2 in the VERSION column.
Step 4: Download Docker Desktop for Windows
Download Docker Desktop from the official Docker website rather than from third-party download sites.
Download Docker Desktop for Windows
Docker provides different Windows installer options, including versions for x86_64 and an Arm version currently described as early access. Choose the installer appropriate for your computer.
After downloading the installer, locate:
Docker Desktop Installer.exe
Step 5: Start the Docker Desktop Installation
Double-click Docker Desktop Installer.exe.
The installer will guide you through the setup process.
For most users, the per-user installation is the simplest option. Docker currently recommends per-user installation for most users because it does not require administrator privileges for installation or updates.
During installation, you may be asked which backend you want to use.
For a typical Windows development environment, choose:
Use WSL 2 instead of Hyper-V
Docker uses WSL 2 as the default backend on supported configurations, and it is suitable for running Linux containers on Windows.
Follow the remaining instructions displayed by the installer.
When the installation finishes, click Close.
Step 6: Launch Docker Desktop
Open the Windows Start menu and search for:
Docker Desktop
Launch the application.
The first startup can take a little longer while Docker initializes its backend and required components.
If Docker Desktop starts successfully, you should see the Docker Desktop interface.
Depending on your configuration, Docker may ask you to accept its terms and complete additional setup steps.
Step 7: Enable WSL 2 Integration
After Docker Desktop starts, open:
Settings → Resources → WSL Integration
Enable integration with the WSL distribution you want to use.
For example, if you use Ubuntu inside WSL, enable Ubuntu integration.
Docker Desktop does not require a specific Linux distribution to run Docker commands from Windows, but WSL integration allows you to use Docker directly from your Linux distribution’s terminal.
Click Apply or Apply & Restart when prompted.
Step 8: Verify the Docker Installation
Once Docker Desktop is running, open PowerShell, Command Prompt, or a WSL terminal.
Run:
docker --version
You should see the installed Docker version.
You can also run:
docker info
This displays information about the Docker environment and confirms that the Docker daemon is responding.
For a practical test, run:
docker run hello-world
Docker should download the hello-world image and create a container.
If the command finishes successfully and displays the welcome message, your Docker installation is working correctly.
Step 9: Run Your First Docker Container
After confirming that Docker works, you can try running a real application.
For example, the following command downloads an Nginx image and starts a web server:
docker run -d -p 8080:80 --name my-nginx nginx
Open your web browser and visit:
http://localhost:8080
You should see the Nginx welcome page.
To view running containers, use:
docker ps
To stop the container:
docker stop my-nginx
To remove it:
docker rm my-nginx
These basic commands are a good starting point for learning how Docker containers work.
Docker Desktop vs. Docker Engine
It’s important to understand the difference between Docker Desktop and Docker Engine.
Docker Engine is the underlying container technology responsible for building and running containers.
Docker Desktop packages Docker Engine and other tools into a convenient desktop environment designed for developers.
On Windows, Docker Desktop handles much of the virtualization and integration work required to run Linux containers.
This makes Docker Desktop especially convenient for developers who want to work with containers without manually managing a Linux virtual machine.
Common Docker Desktop Installation Problems
Docker Says WSL 2 Is Not Installed
If Docker reports that WSL 2 is unavailable, open an elevated PowerShell window and run:
wsl --install
Then restart Windows if requested.
After restarting, update WSL:
wsl --update
Check the installation:
wsl --version
Docker recommends using a current WSL release because outdated WSL versions can cause Docker Desktop problems.
Docker Desktop Won’t Start
One common cause is disabled hardware virtualization.
Check Task Manager → Performance → CPU and make sure virtualization is enabled.
Docker also identifies missing WSL 2 components, Windows virtualization features, and BIOS virtualization settings as potential causes of startup errors.
Docker Reports a Hyper-V or Virtualization Error
If you see an error related to Hyper-V, HCS, or virtualization, verify that:
- Hardware virtualization is enabled in BIOS/UEFI.
- WSL 2 is installed correctly.
- Windows virtualization components are enabled.
- Windows is fully updated.
- You are not running another virtualization configuration that conflicts with Docker.
Docker’s troubleshooting documentation specifically notes that disabled BIOS virtualization and missing WSL 2 or Windows virtualization components can prevent Docker Desktop from functioning correctly.
Docker Commands Do Not Work Inside WSL
If docker works from Windows but not from your Linux distribution, check:
Docker Desktop → Settings → Resources → WSL Integration
Make sure integration is enabled for the distribution you’re using.
You can also check the distribution’s WSL version with:
wsl --list --verbose
If necessary, convert a distribution to WSL 2 with:
wsl --set-version Ubuntu 2
Replace Ubuntu with the name of your distribution.
Tips for Better Docker Performance on Windows
Keep WSL Updated
Using the latest WSL release can improve compatibility and reliability. Docker recommends keeping WSL current.
Store Development Projects in WSL
For WSL-based development, Docker recommends keeping project files inside the Linux distribution when possible. This can provide a better development experience and file-system performance than working with projects stored on the Windows filesystem.
Monitor Docker’s Resource Usage
Containers can consume significant CPU, memory, and storage resources.
If you’re running databases, development servers, or multiple containers simultaneously, keep an eye on Docker Desktop’s resource usage and adjust its configuration when necessary.
Clean Up Unused Docker Resources
Over time, Docker can accumulate unused containers, images, and volumes.
You can review unused resources with commands such as:
docker ps -a
and:
docker images
Remove resources you no longer need to recover disk space.
Be careful when deleting volumes because they can contain persistent application data.
Is Docker Desktop Free?
Docker Desktop has licensing requirements that depend on how it is used. Docker states that commercial use in larger enterprises—organizations with more than 250 employees or more than $10 million USD in annual revenue—requires a paid subscription.
Individual developers, smaller organizations, education, and other qualifying users may be able to use Docker Desktop under Docker’s applicable terms.
Always check the current Docker Subscription Service Agreement if you’re installing Docker Desktop for business use.
Frequently Asked Questions
Can I install Docker Desktop on Windows Home?
Yes, Docker Desktop can run Linux containers on supported Windows Home configurations using WSL 2. Windows Home does not support Windows containers through Docker Desktop.
Do I need WSL 2 to use Docker Desktop?
WSL 2 is the default and recommended backend for many Windows installations, but Docker Desktop also supports other backends depending on the installation and Windows configuration.
How much RAM does Docker Desktop require?
Docker lists 8 GB of system RAM among the hardware prerequisites for WSL 2-based Docker Desktop on Windows. Actual memory usage can be considerably higher depending on the containers and applications you run.
Can I run Docker without administrator privileges?
Docker’s current Windows documentation supports a per-user installation that does not require administrator privileges for installation or updates. Some operations and settings still require elevation.
How do I know Docker is installed correctly?
Run:
docker run hello-world
If Docker successfully downloads and runs the image, your installation is working.
Final Thoughts
Installing Docker Desktop on Windows is much easier when you prepare WSL 2 and hardware virtualization first. For most Windows developers, the WSL 2 backend provides a practical way to run Linux containers while continuing to use familiar Windows tools.
The basic process is:
- Check your Windows version.
- Enable hardware virtualization.
- Install or update WSL 2.
- Download Docker Desktop from Docker.
- Install Docker Desktop using the WSL 2 backend.
- Enable WSL integration.
- Test Docker with
docker run hello-world. - Start experimenting with containers.
Once Docker is working, you can move on to Docker Compose, containerized databases, development environments, and more advanced container workflows.
