DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
Redmond desk3 min

How to Install WSL Containers on Windows 11

Install WSL on Windows 11, then choose Microsoft’s built-in wslc.exe container CLI or Docker Desktop with its WSL 2 backend.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

“WSL containers” can mean Microsoft’s built-in wslc.exe command-line tool or the more established Docker Desktop workflow using its WSL 2 backend. Both run Linux containers through a Linux environment on Windows, but they are separate setups. Install WSL first, then follow the route that matches the tools you want to use.

Before you start: choose the container workflow

Microsoft’s wslc.exe is a container CLI shipped with WSL. Docker Desktop is a separate application with its own engine settings and WSL integration, and it is the relevant route for Docker-based development workflows such as Dev Containers. The reviewed documentation does not establish full feature parity between the two, so do not assume one is a universal replacement for the other.

As an Amazon Associate I earn from qualifying purchases.

Route Choose it when Key setup detail
Microsoft’s wslc.exe You specifically want to use WSL’s built-in container CLI. Microsoft’s cited documentation requires WSL 2.9.3 or later and describes the feature as pre-release.
Docker Desktop with WSL 2 You want Docker Desktop tooling, including its WSL integration for a Linux distribution or a Dev Containers workflow. Enable the WSL 2 based engine and integration for the distribution you use.

These instructions concern Linux containers. Linux containers share a Linux kernel, so Windows uses a Linux environment for them. Windows containers are a different workload and mode; identify the image type you intend to run before applying Linux-container setup or troubleshooting steps. See Microsoft’s WSL containers tutorial and Microsoft’s Windows containers quick-start guidance.

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

Install WSL and set up a Linux distribution

  1. Open PowerShell as an administrator.
  2. Run wsl --install. Microsoft says this enables the required Windows features and installs the default Ubuntu distribution. Restart Windows if prompted.
  3. Launch the installed Linux distribution from the Start menu and complete its first-run setup.
  4. If WSL was already installed and wsl --install displays help rather than installing a distribution, list available distributions with wsl --list --online, then install one with wsl --install -d <DistroName>.

Follow Microsoft’s WSL installation instructions and environment setup guidance if you need the full distribution setup details.

Option 1: Install and use Microsoft’s built-in wslc.exe

Microsoft documents wslc.exe as a WSL-shipped Linux container CLI, with a minimum WSL version of 2.9.3. Its tutorial currently describes the feature as pre-release and directs users to update to pre-release WSL builds. Because release status and version requirements can change, check Microsoft’s live documentation before installing or relying on this route.

  1. In PowerShell, update WSL to the pre-release build as directed by Microsoft: wsl --update --pre-release.
  2. Check Microsoft’s current WSL containers documentation for the applicable version requirement and any release-status changes.
  3. Use Microsoft’s documented example to run an Ubuntu container: wslc run --rm -it ubuntu:latest bash -c "echo Hello world from WSL container!".
  4. To list images, use the documented example command: wslc image ls.

The commands above are examples published by Microsoft, not a claim of an independently tested installation. See the WSL containers tutorial and Microsoft’s WSL release notes for current details.

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.

Option 2: Configure Docker Desktop to use WSL 2

  1. Install Docker Desktop for Windows using Docker’s Windows installation guide.
  2. Open Docker Desktop and go to Settings > General. Enable Use WSL 2 based engine.
  3. Go to Settings > Resources > WSL integration and enable integration for the Linux distribution you plan to use.
  4. For a VS Code Dev Containers workflow, make sure Docker Desktop is running before opening VS Code.

For Docker-based development, Microsoft recommends keeping project files in the WSL filesystem—for example, /home/yourname/projects/. Accessing files stored on the Windows filesystem crosses the OS boundary and can be significantly slower, particularly during builds and file watching. See Microsoft’s Windows-specific Dev Containers guidance.

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.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Check the container type before troubleshooting

If a container will not start, first establish whether its image is for Linux or Windows containers. Linux containers need a Linux environment; Windows containers are a distinct workload and are not enabled merely by configuring WSL’s Linux-container workflow. Microsoft’s WSL container documentation and Windows containers quick start describe these as separate paths.

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
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
Rank #3

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.

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.