How to install WSL Containers in Windows 11
WSL containers run Linux applications directly inside Windows 11 without the need for a separate virtual machine. This feature bridges the Windows Subsystem for Linux (a tool that lets you run Linux software on Windows) with container platforms like Docker.
Microsoft introduced this capability in WSL version 1.0.0 to speed up container workflows. You skip heavy setup steps and run your containers directly inside your normal Windows workspace.
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
Start by updating the Windows Subsystem for Linux (WSL).
Open Command Prompt as Administrator
Certain system operations, such as updating WSL, require administrative privileges in the terminal.
Update WSL to the Pre-Release Version
Windows Subsystem for Linux (WSL – a tool that lets you run Linux on Windows) needs an update to its pre-release version before you can install WSL containers. Open Command Prompt as an administrator and type wsl –update –pre-release to download the latest test files. This makes sure your system has the new features needed for container support.
Run `wsl --update --pre-release` to download the newest test packages. This can take a few minutes depending on your network speed.
Restart WSL
Windows Subsystem for Linux (WSL) must shut down completely to apply the new pre-release updates. Open Command Prompt as an administrator and type wsl --shutdown to stop all active background processes. Save your work first, because this command closes any running Linux environments right away without asking for confirmation.
wsl --shutdownThis command stops all active WSL processes without showing much visual feedback.
Save all open work inside WSL environments before executing wsl --shutdown. Active Linux processes close instantly upon execution.
Step 2Check Your WSL Installation
Following updates and reboots, verifying functionality ensures the system recognizes the new container features.
Check the WSL Version
Checking the installed WSL version confirms container support is active.
wsl --versionA version string matching 2.9.3.0 or higher should appear. Seeing a list of command options and usage instructions confirms the environment is configured correctly.
Confirm the New Container Tool
Windows Subsystem for Linux (WSL) container tools need a quick check to make sure everything installed properly. Open Command Prompt as an administrator and type wslc --help to test the system. A long list of commands and usage instructions appears on screen if the installation worked and the container tool is ready to use.
wslc --helpA displayed list of options and usage instructions confirms the system is on the right track. WSL Containers are installed and ready for deployment.
Troubleshooting Tip: If the wslc --help command fails, verify that wsl --update --pre-release completed without errors. Next, re-run wsl --shutdown. Close the Command Prompt or Terminal window entirely before opening a fresh instance and retrying wslc --help. A full system reboot occasionally resolves persistent configuration snags.
Reference:
https://learn.microsoft.com/en-us/windows/wsl/wsl-container?tabs=csharp
Summary
This guide details installing the WSL Containers preview on Windows 11. Readers learn about required system updates, necessary reboots for applying configuration changes, and verification steps for validating a successful installation.
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!