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

To run Linux containers from Windows, install and update WSL 2, install Docker Desktop for Windows, enable its WSL 2 engine, and turn on integration for your Linux distribution. Then run Docker commands in that distribution’s terminal. WSL provides the Linux kernel and distribution environment; Docker Desktop provides the integrated container backend and Windows-side connection.

What WSL 2 and Docker Desktop each do

WSL 2 runs a Linux environment on Windows using a Microsoft-provided Linux kernel. Docker Desktop connects that environment to the engine that runs Linux containers. Linux containers cannot run directly on the Windows kernel because containers share a kernel with their host; as Microsoft explains, virtualization is needed to run Linux containers on Windows.

For the Windows getting-started setup, use Docker Desktop’s WSL 2 backend rather than installing a separate Docker Engine inside the distribution. Docker warns that a separately installed engine or CLI can conflict with Docker Desktop’s integration.

Check prerequisites and install WSL

Docker’s current WSL guidance requires WSL 2.1.5 or later and recommends the latest WSL version. You also need to meet Docker Desktop for Windows’ system requirements. Microsoft’s wsl --install setup flow supports Windows 10 version 2004 (build 19041) or later, and Windows 11.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
SSK Portable SSD 1TB External Solid State Hard Drive USB C Up to 1050MB/s
  • Capacity Display Variance: 1TB external ssd often appears as around 931GB on Windows. MacOS can show full 1 TB capacity. This is binary calculation difference and doesn’t affect SSD hard drive actual physical storage
  • 1050 MB/s Speed: Instantly access to your files with blazing-fast 10Gbps external SSD read up to 1050MB/s and write up to 1000MB/s. LED Light indicates USB SSD instant activity
  • Data Security: Solid state drives S.M.A.R.T. health diagnostics​ and adaptive TRIM optimizing data block management ensures consistent write speeds and extends the longevity of the portable SSD
  • USB-C & USB-A Cable: Both cables featuring rapid USB 3.2 Gen2, this USB SSD effortlessly bridges devices, enabling seamless cross-platform file transfers and backup between computers, smartphones, tablets and iPhone
  • Always Fast: No slowdowns for large file transfers. With SLC caching (25% of current available capacity allocated as high-speed cache), this external SSD delivers steady 10Gbps for transfers within the cache capacity
  1. Open PowerShell or Command Prompt as an administrator and run wsl --install. Microsoft’s flow enables the WSL and Virtual Machine Platform components, installs the latest Linux kernel, sets WSL 2 as the default, and installs Ubuntu. Restart Windows if prompted.

  2. To install a different available distribution, use wsl --list --online to see the choices, then wsl --install -d <DistributionName>, replacing the example with the distribution’s listed name.

  3. Start the distribution from the Start menu or by running wsl. Complete its first-run setup, including creating a Linux username and password.

Docker recommends removing any Docker Engine or Docker CLI installed directly inside a WSL distribution before using Docker Desktop integration. Keeping both setups in the same distribution can cause conflicts.

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

Install Docker Desktop and enable its WSL 2 engine

  1. Download and install Docker Desktop for Windows, then start Docker Desktop.

    Rank #2
    Sale
    Samsung T7 Portable SSD 1TB Titan Gray, USB 3.2 Gen 2, Up to 1,050MB/s
    • MADE FOR THE MAKERS: Create; Explore; Store; The T7 Portable SSD delivers fast speeds and durable features to back up any endeavor; Build your video editing empire, file your photographs or back up your blogs all in an instant
    • SHARE IDEAS IN A FLASH: Don’t waste a second waiting and spend more time doing; The T7 is embedded with PCIe NVMe technology that brings fast read and write speeds up to 1,050/1,000 MB/s¹, making it almost twice as fast as the T5
    • ALWAYS MAKE THE SAVE: Compact design with massive capacity; With capacities up to 4TB, save exactly what you need to your drive – from large working files to game data and everything in between
    • ADAPTS TO EVERY NEED: Whether using a PC or mobile phone, count on the T7 for extensive compatibility²; It’s a true team player when it comes to heavy-duty application usage or file-saving
    • HI RESOLUTION VIDEO RECORDING: Record Ultra High Resolution (4K 60fs) videos directly onto the T7 Portable SSD with your favorite camera or mobile devices; Supports iPhone 15 Pro Res 4K at 60fps video and more³
  2. Open Settings > General, select Use WSL 2 based engine, and choose Apply & Restart.

On systems that support WSL 2, Docker says this option is enabled by default and may not appear in Settings.

Enable your distribution’s Docker integration

  1. In Windows, check your installed distributions and their WSL versions with wsl.exe -l -v.

    Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  2. If your chosen distribution shows version 1, convert it by running wsl.exe --set-version <distribution name> 2, using the name exactly as shown in the list. To make WSL 2 the default for future installations, run wsl.exe --set-default-version 2.

  3. In Docker Desktop, open Settings > Resources > WSL Integration and enable the switch for your distribution. Docker integrates Ubuntu by default unless you change the selected distribution.

    Rank #3
    Lexar ES3 1TB Portable SSD Silver, USB 3.2 Gen 2 up to 1050MB/s
    • Note: Magsafe is not available in this version
    • High-speed Data Transfer: Lexar external SSD ES3 supports USB 3.2 Gen 2 up to 1050MB/s read and 1000MB/s write to transfer files fast for more efficient work. (Performance may be lower if not supporting USB 3.2 Gen 2 on Mac and other systems)
    • Wide Compatibility: Lexar Portable SSD ES3 compatibility with iPhone 17 series (Not supported on iPhone 14 and older models), Android mobile devices, laptops, cameras, Xbox X|S, PS4, PS5, gaming console, and more
    • On The Go: Lexar external solid state drive ES3's thin, stylish, and durable design, weighs 42g and is only 10.5mm thick, making it smaller than a card and easily fits in your pocket. It comes with a Type-C cable for plug-and-play convenience
    • Data Safety First: Lexar SSD ES3 includes Lexar DataShieldTM 256-bit AES encryption software to protect files

If WSL Integration is missing, Docker Desktop may be in Windows-container mode. Switch it to Linux containers; WSL integration is for the Linux-container workflow.

Run your first Linux container from WSL

Open a terminal for the distribution you enabled and run these standard Docker CLI commands:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Check that the Docker client can reach the engine: docker version. The output should include both client and server information.

  2. Download the small test image: docker pull hello-world.

  3. Run it and remove the stopped container afterward: docker run --rm hello-world. A successful run prints a message explaining that Docker is working.

    Rank #4
    SSK Portable SSD 500GB External Solid State Hard Drive USB C Up to 1050MB/s
    • Capacity Display Variance: 500GB external ssd often appears as around 465GB on Windows. MacOS can show full 500 GB capacity. This is binary calculation difference and doesn’t affect SSD hard drive actual physical storage
    • 1050 MB/s Speed: Instantly access to your files with blazing-fast 10Gbps external SSD read up to 1050MB/s and write up to 1000MB/s. LED Light indicates USB SSD instant activity
    • Data Security: Solid state drives S.M.A.R.T. health diagnostics​ and adaptive TRIM optimizing data block management ensures consistent write speeds and extends the longevity of the portable SSD
    • USB-C & USB-A Cable: Both cables featuring rapid USB 3.2 Gen2, this USB SSD effortlessly bridges devices, enabling seamless cross-platform file transfers and backup between computers, smartphones, tablets and iPhone
    • Always Fast: No slowdowns for large file transfers. With SLC caching (25% of current available capacity allocated as high-speed cache), this external SSD delivers steady 10Gbps for transfers within the cache capacity

These commands are illustrative examples of normal Docker CLI usage; they are not a claim that a particular machine was tested.

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

Choose where to keep project files

For projects that Docker bind-mounts into Linux containers, Docker recommends storing source code and related active development data in the Linux filesystem—for example, under your distribution’s home directory. This generally offers better bind-mount performance than working from Windows-mounted paths.

Windows files remain accessible through mounted paths in WSL when needed. The practical distinction is where the project lives: keep frequently mounted and watched files in the Linux filesystem when performance matters; use Windows-mounted files where that location is more useful, allowing for possible differences in bind-mount and file-watching performance.

Use VS Code with a WSL project

You can work from the WSL shell and keep VS Code as your editor interface. Docker’s suggested workflow is to enable the distribution’s integration, open a WSL shell, move to the project directory, and run code .. With Microsoft’s WSL extension, the VS Code client stays on Windows while its remote server runs inside the Linux distribution.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshoot common setup problems

  • The distribution is still WSL 1: Run wsl.exe -l -v and convert it with wsl.exe --set-version <distribution name> 2.

    Free tools Windows power users keep installed

    One-click scans. No signup required.

    Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
    Best Value
    SSK 1TB External SSD Drive up to 550MB/s Dual USB C+A 3. 2 Thumb Drive
    • Dual Drive USB Type C + USB A: Equipped with an USB-C port and USB-A 3.2 port,SSK Dual USB SSD solid state drive allows you transfer data between smartphone/tablet and computer more conveniently. Instantly release space or quickly move pictures or movies on your OTG enabled Android Type C phone, tablet, MacBook, Windows computer, car audio system, smart TV and more.
    • Ultra Fast Transfer Speed: SSK USB 3.2 Gen 2 Solid State SSD drive up to 550mb/s read speed and 500mb/s write speed, which is 10 times faster than traditional USB 3.0 flash drive and memory stick. Let you move high-resolution photos, videos and large-capacity files fast. Based on internal testing, performance may vary slightly due to factors such as host equipment, interfaces, and usage conditions.
    • Plug and Play: SSK dual drive supports plug and play, without any software installation. At the same time, USB SSD stick can expand the capacity of phones and computer. It is convenient for everyone to use the mobile phone to directly read the thumb drive for file sharing, data transmission, and video playback when working or studying.
    • Safe & Reliable: SSK USB SSD drive is made of high-grade zinc alloy shell, it has excellent shock resistance and fast heat dissipation performance to better protect your data. The design of the double-head protective cover better protects the two interfaces.Safe & Reliable: SSK USB SSD drive is made of high-grade zinc alloy shell, it has excellent shock resistance and fast heat dissipation performance to better protect your data. The design of the double-head protective cover better protects the two interfaces.
    • Universal Compatibility: High speed USB stick external storage compatible with computer equipment, smart TV, car audio, smart phones, iPhone 15, iPad, Laptops, Macbook and more. Backward-compatible with USB 3.0 and USB 2.0 ports. Comes with default format EXFAT, it works with most systems such as Windows/Linux/Mac OS./Android.Only compatible with products with UAB A/USB C interface.(Incompatible with lightning port)
  • docker commands fail in the WSL terminal: Confirm Docker Desktop is running and that the distribution is enabled under Settings > Resources > WSL Integration.

  • There is no WSL Integration setting: Check whether Docker Desktop is using Windows containers, then switch to Linux containers.

  • Docker behaves inconsistently in the distribution: Remove a separately installed Docker Engine or CLI there; Docker Desktop’s integrated setup can conflict with those installations.

  • Bind mounts or file watching are slow: Move the active project into the Linux filesystem rather than keeping it under a Windows-mounted path.

    What’s actually slowing this PC down?

    Pick the symptom - the matching free tool is one click away.

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

How the setup choices compare

Choice What it means When it fits
Docker Desktop with WSL 2 integration Docker Desktop supplies the integrated backend and connects enabled WSL distributions to it. Docker’s documented Windows getting-started path for Linux containers.
Separately managed Docker Engine inside WSL The distribution has its own Docker installation instead of relying on Desktop’s integration. A distinct setup to manage separately; Docker warns it can conflict with Docker Desktop integration in the same distribution.
Project in the Linux filesystem Source files reside within the WSL distribution. Docker recommends this for bind-mounted development data and performance.
Project in a Windows-mounted path Source files reside on Windows and are accessed from WSL through a mounted path. Useful when Windows-side access is needed, with potentially different bind-mount performance.
WSL terminal only Run Docker commands and use shell tools directly in the distribution. A command-line development workflow.
VS Code connected to WSL Use the Windows VS Code client with its remote server in the Linux distribution. Editor workflow that operates on files and tools inside WSL.

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.