WSL container | Microsoft Learn
Table of contents
Exit editor mode
Ask Learn
Ask Learn
Reading mode
Table of contents
Read in English
Add
Add to plan
Edit
Copy Markdown
Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
WSL container
Feedback
Summarize this article for me
WSL container is a new feature coming to WSL with the goal of making it easier to use Linux containers on Windows. It has two major components: a CLI called wslc.exe to build, run and interact with Linux containers and a WSL container API allowing Windows app developers to use Linux containers as part of their app logic.
Currently WSL container is in development, and since WSL is open sourced you can view the progress at the WSL GitHub repo microsoft/wsl. To learn more when this feature is fully released please stay tuned to the Windows command line blog!
WSL container CLI
In the next WSL update, wslc.exe will be an included command as part of the regular update. Its goal is to have a familiar CLI interface, allowing you to easily build, run and interact with Linux containers.
See some of the example commands below:
# Run a container<br>wslc run --rm -it ubuntu:latest bash -c "echo Hello world from WSL container!"<br># List available images<br>wslc image ls<br># Run a web server<br>wslc run -it --rm -d -p 8080:80 --name web nginx<br># Get its content<br>curl localhost:8080<br># List the container<br>wslc container ps<br># Stop the container<br>wslc container stop web
WSL container API
Windows applications can make use of Linux containers as well! A nuget package will be available allowing you to programmatically pull, run, and interact with Linux containers. Including key interactions like stdin and stdout, file mounts, networking mounts, GPU access and more.
Collaborate with us on GitHub
The source for this content can be found on GitHub, where you can also create and review issues and pull requests. For more information, see our contributor guide.
Windows Subsystem for Linux
Open a documentation issue
Provide product feedback
Feedback
Was this page helpful?
Yes
No
No
Need help with this topic?
Want to try using Ask Learn to clarify or guide you through this topic?
Ask Learn
Ask Learn
Suggest a fix?
Additional resources
Last updated on<br>2026-06-02
Was this page helpful?
Need help with this topic?
Want to try using Ask Learn to clarify or guide you through this topic?
Ask Learn
Ask Learn
Suggest a fix?