How to install WSL Containers in Windows 11
WSL Containers let you run and manage Linux containers directly within Windows 11.
This new feature builds on the Windows Subsystem for Linux (WSL), which already lets you use Linux tools and apps on your PC.
WSL Containers simplify container management by integrating it into your existing WSL setup, making tasks quicker.
Microsoft introduced WSL Containers with the release of WSL version 1.0.0.
It means you can now use popular container tools like Docker, but through your WSL environment.
Update your WSL to the pre-release version by running ‘wsl –update –pre-release’ as administrator, then restart WSL with ‘wsl –shutdown’. Finally, verify the installation by typing ‘wslc –help’ in Command Prompt.
Step 1Get Your WSL Ready for the Preview
Before you can use containers, you need to update your WSL to the latest preview version. This is where the setup process begins.
Open Command Prompt as Administrator
You need to open Command Prompt as an administrator to run certain commands, like updating WSL.
Tip: Running as an administrator lets you make system changes without permission problems.
Update WSL to the Pre-Release Version
In the administrator Command Prompt window, type this command and press Enter:
wsl --update --pre-releaseThis command instructs WSL to search for and download the latest experimental updates. It might take a little while. This depends on your internet speed and how much needs to be downloaded.
Restart WSL
After updating WSL, you must restart it completely to apply the changes.
wsl --shutdownThis command will safely stop all running WSL programs. You won’t see much happen on the screen. But it’s a very important step.
Warning: Make sure you save any work in your WSL programs before running wsl --shutdown. This command will close all active Linux programs.
Step 2Check Your WSL Installation
Now that you’ve updated and restarted, let’s make sure everything is working. We also need to confirm that the new container features are recognized.
Check the WSL Version
Checking your WSL version confirms you have the necessary support for containers.
wsl --versionYou should see a version number like 2.9.3.0 or a newer one. If this command displays a list of options and usage instructions, you’re on the right track!
Confirm the New Container Tool
The main tool for managing WSL containers is called wslc, and you can confirm it’s ready by running a simple command.
wslc --helpIf this command displays a list of options and usage instructions, you’re on the right track! WSL Containers are installed and ready for you to use.
Troubleshooting Tip: If the wslc --help command doesn’t work, don’t worry! First, check that the wsl --update --pre-release command finished without any mistakes. Then, try running wsl --shutdown again. Close your Command Prompt or Terminal window completely. Open it again and try wslc --help one more time. Sometimes, restarting your whole computer can also fix problems.
Reference:
https://learn.microsoft.com/en-us/windows/wsl/wsl-container?tabs=csharp
Summary
This guide walks you through installing the WSL Containers preview on Windows 11, covering updates, restarts, and verification.
Was this guide helpful?
About the Author
Richard
Tech Writer, IT Professional
Richard, a writer for Geek Rewind, is a tech enthusiast who loves breaking down complex IT topics into simple, easy-to-understand ideas. With years of hands-on experience in system administration and enterprise IT operations, he’s developed a knack for offering practical tips and solutions. Richard aims to make technology more accessible and actionable. He's deeply committed to the Geek Rewind community, always ready to answer questions and engage in discussions.
No comments yet — be the first to share your thoughts!