How to install WSL Containers in Windows 11
WSL containers run Linux apps right on your Windows 11 PC without needing a separate virtual machine. This built-in feature connects the Windows Subsystem for Linux (WSL), which lets you run Linux tools on Windows, with popular container tools like Docker.
Microsoft first added this setup in WSL version 1.0.0 to make working with Linux containers much faster and easier. 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
Getting started requires updating the Windows Subsystem for Linux (WSL) to the latest preview build. This marks the beginning of the configuration process.
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
Installing WSL containers requires updating the Windows Subsystem for Linux (WSL) to its pre-release version first. Launch Command Prompt with administrative privileges and execute `wsl –update –pre-release`. Depending on network speeds, downloading the test packages takes a few moments.
The `wsl --update --pre-release` command tells Windows Subsystem for Linux (WSL) to fetch the newest test packages. Downloading these updates takes time, usually a few minutes. Network bandwidth and package size (which reaches up to 100 megabytes) dictate download speed.
Restart WSL
Execute `wsl --shutdown` in an elevated terminal window. Save active work beforehand, because this action immediately terminates all running Linux instances.
wsl --shutdownThis command terminates all active WSL processes silently. The interface displays very little visual feedback, but completion of this phase is mandatory.
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
Post-update checks require validating the new container utility, wslc. Launch Command Prompt with administrative privileges and execute `wslc --help` to verify operational status. A generated instruction manual confirms successful installation of WSL Containers.
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!