Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run Scan×
Skip to content
Redmond desk4 min

How to Set Up Docker Desktop with WSL 2 on Windows 11

Set up Docker Desktop with WSL 2 on Windows 11, from checking requirements and updating WSL to enabling Linux distribution integration and fixing common problems.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To use Docker Desktop with WSL 2 on Windows 11, first confirm your Windows edition and hardware meet Docker’s requirements, update WSL, install Docker Desktop with the WSL 2 engine, then enable integration for the Linux distribution you want to use. Keep active project files in that distribution’s Linux filesystem for Docker’s recommended development workflow.

Check Windows, WSL, and hardware requirements

Docker’s Windows installation documentation lists Windows 11 Enterprise, Pro, or Education version 23H2 (build 22631) or later, WSL 2.1.5 or later, a 64-bit processor with Second Level Address Translation (SLAT), at least 8 GB of system RAM, and hardware virtualization enabled in BIOS or UEFI. Docker supports Windows versions that remain within Microsoft’s servicing timeline, so check the current Docker Windows installation requirements and Microsoft’s support status for your specific Windows release before proceeding.

As an Amazon Associate I earn from qualifying purchases.

  • In Windows, run winver to check the release and build.
  • Confirm virtualization is enabled in your PC’s BIOS or UEFI settings.
  • Open PowerShell or Command Prompt and run wsl --version. Docker says that if version details do not appear, the system may have the older inbox version of WSL and needs an update or WSL installation.

Install or update WSL 2

Microsoft’s wsl --install command enables the WSL and Virtual Machine Platform components, downloads and installs the latest Linux kernel, sets WSL 2 as the default, and installs Ubuntu by default. A restart may be required. For Microsoft’s current instructions and supported options, see Install WSL.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Open PowerShell as an administrator.
  2. Run wsl --install.
  3. Restart Windows if prompted, then complete the Linux distribution’s first-run setup.
  4. Check the installed WSL version with wsl --version. To update an existing installation, run wsl --update, then check the version again.

If you already have a Linux distribution, check its WSL mode with wsl.exe -l -v. Docker’s setup instructions explain how to convert a distribution to version 2 if it is currently using version 1.

Install Docker Desktop and enable WSL integration

Download Docker Desktop from Docker’s Windows installation page. Before installation, remove any Docker Engine or Docker CLI installed directly inside a WSL distribution: Docker warns that running those alongside Docker Desktop’s integration can cause conflicts.

  1. Install Docker Desktop and start it.
  2. Open Settings > General and check Use WSL 2 based engine. Docker says this is enabled by default when WSL 2 is supported; select it and apply the change if it is not enabled.
  3. Open Settings > Resources > WSL Integration.
  4. Turn on integration for the Linux distribution where you plan to run Docker commands, then apply the change.
  5. Open that distribution’s terminal and run docker version to check that the Docker client can reach the engine.

The WSL integration toggle is per distribution. Docker commands are also available from Windows terminals, even if you do not install a separate Linux distribution. If WSL Integration is missing from Settings, Docker says the application may be in Windows-container mode; switch to Linux containers for this WSL integration workflow. See Docker Desktop WSL 2 backend for Docker’s integration instructions.

Rank #2
Dell Latitude 5420 14" FHD Business Laptop Computer, Intel Quad-Core i5-1145G7, 16GB DDR4 RAM, 256GB SSD, Camera, HDMI, Windows 11 Pro (Renewed)
  • 256 GB SSD of storage.
  • Multitasking is easy with 16GB of RAM
  • Equipped with a blazing fast Core i5 2.00 GHz processor.

Keep development files in the Linux filesystem

For the best Docker Desktop and WSL development experience, Docker recommends storing code in the default Linux distribution rather than working from the Windows-mounted filesystem. Docker does not attach a guaranteed numerical speedup to this guidance.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A common workflow is to open a WSL terminal, navigate to the project directory in the Linux filesystem, and run code .. With the VS Code WSL extension, the Windows IDE client connects to the Linux distribution while the project remains in its Linux filesystem. Docker describes this approach in its WSL best practices.

Rank #3

Troubleshoot integration and resource problems

Docker commands are unavailable in a distribution

  • Confirm Docker Desktop is running and the WSL 2 engine is selected under Settings > General.
  • Check Settings > Resources > WSL Integration and enable the distribution you are using.
  • Run wsl.exe -l -v and make sure that distribution is using version 2.
  • Remove any Docker Engine or CLI installed directly inside the distribution if it conflicts with Docker Desktop integration.

Integration settings are missing

Check whether Docker Desktop is in Windows-container mode. For the WSL integration workflow, switch to Linux containers.

Docker hangs, WSL uses excessive memory, or upgrades fail

Docker’s WSL best-practices guidance associates outdated WSL versions with issues such as periodic Docker hangs, upgrade problems, vmmem.exe using all memory, network-filter-policy problems, and GPU failures. Docker sets WSL 2.1.5 as its minimum for the backend and recommends keeping WSL current. Update WSL with wsl --update and review the current Docker WSL best practices.

Rank #4
Windows 11 Laptop with i3 Processor 15.6" Work Laptop for College Students
  • 【Efficient Performance】 Powered by Intel Core i3 processor (2 cores, 4 threads, up to 3.4GHz) with 12GB RAM and 256GB SSD. Handles multitasking, office software, online classes, and HD video streaming smoothly. Integrated Intel UHD Graphics 620
  • Backlit Keyboard & Complete Package】Comes with a cool backlit keyboard. Comes with awebcam, dual stereo speakers (8Ω/1.0W each), DC charger, and user manual – ready for late-night studying, online classes, video conferencing, and daily productivity
  • 【Vibrant Display】 15.6-inch Full HD (1920x1080) anti-glare screen with 16:9 aspect ratio delivers crisp images and vivid colors – perfect for studying, watching lectures, or entertainment. Thin-bezel design maximizes viewing area
  • 【Fast Connectivity & Expansion】 Equipped with WiFi 6 (802.11ax) and Bluetooth 5.2 for stable, high-speed wireless. Features 3 x USB 3.0, HDMI 2.1, Type-C (supports PD3.0 fast charging), and a TF card slot expandable up to 2TB – easily connect external monitors, mice, drives, or expand storage for all your files
  • 【Long Battery Life & Portable】 Built-in 11.55V 5000mAh/57.75Wh high-capacity battery delivers approximately 7 hours of mixed-use battery life – enough for a full day of classes and assignments. Lightweight at just 1.63kg (3.6 lbs) and 19.5mm thin, plus a compact packing size – easily slips into a backpack for campus, library, or coffee shop

WSL 2 dynamically allocates memory. Docker notes that autoMemoryReclaim may help reclaim unused memory after image builds; it has been available as an experimental feature since WSL 1.3.10. Treat it as an optional setting, not a required Docker configuration, and consult Microsoft’s current WSL documentation before changing it.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Optional: GPU workloads and enhanced isolation

NVIDIA GPU compute

GPU passthrough is only relevant if Linux containers need GPU compute. Docker documents NVIDIA GPU paravirtualization with the WSL 2 backend; prerequisites include an NVIDIA GPU, an up-to-date Windows installation, supported current NVIDIA drivers, the latest WSL 2 Linux kernel, and Docker Desktop using the WSL 2 backend. Check Docker’s GPU support instructions for current driver and setup details.

Enhanced Container Isolation

Enhanced Container Isolation is an optional security feature, not a baseline requirement for using Docker Desktop with WSL 2. Docker’s best-practices documentation specifies WSL 2.6 or later for ECI because it needs at least Linux kernel 6.3.0; Docker states WSL 2.6 and later bundles kernel 6.6. These version requirements can change, so confirm them in Docker’s current WSL guidance if you intend to enable ECI.

Check Docker Desktop licensing for organizational use

Docker’s Windows installation page states that commercial use of Docker Desktop in larger enterprises—more than 250 employees or more than US$10 million in annual revenue—requires a paid subscription. See Docker’s current installation and licensing information and applicable terms for your organization. Those thresholds do not establish which subscription is appropriate or its price.

Quick Recap

Bestseller No. 1
Bestseller No. 2
Dell Latitude 5420 14' FHD Business Laptop Computer, Intel Quad-Core i5-1145G7, 16GB DDR4 RAM, 256GB SSD, Camera, HDMI, Windows 11 Pro (Renewed)
Dell Latitude 5420 14" FHD Business Laptop Computer, Intel Quad-Core i5-1145G7, 16GB DDR4 RAM, 256GB SSD, Camera, HDMI, Windows 11 Pro (Renewed)
256 GB SSD of storage.; Multitasking is easy with 16GB of RAM; Equipped with a blazing fast Core i5 2.00 GHz processor.
$285.00
Bestseller No. 3
HP 14' HD Laptop, Windows 11, Intel Celeron Dual-Core Processor Up to 2.60GHz, 4GB RAM, 64GB SSD, Webcam, Dale Pink (Renewed)
HP 14" HD Laptop, Windows 11, Intel Celeron Dual-Core Processor Up to 2.60GHz, 4GB RAM, 64GB SSD, Webcam, Dale Pink (Renewed)
14" diagonal, 1366x768 resolution, HD BrightView LED, Glossy NON-TOUCH Display
$245.99

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.