Creating a Custom Linux Distro for WSL
Use our open source WSL sample to build WSL distro packages for the Microsoft Store and/or to create custom Linux distro packages for sideloading. You can find the distro launcher repo on GitHub.
This project enables:
- Linux distribution maintainers to package and submit a Linux distribution as an appx that runs on WSL
- Developers to create custom Linux distributions that can be sideloaded onto their dev machine
We distribute Linux distros for WSL as UWP applications through the Microsoft Store. You can install those applications that will then run on WSL - the subsystem that sits in the Windows kernel. This delivery mechanism has many benefits as discussed in an earlier blog post.
Sideloading a Custom Linux Distro Package
You can create a custom Linux distro package as an application to sideload on your personal machine. Please note that your custom package would not be distributed through the Microsoft Store unless you submit as a distribution maintainer. To set up your machine to sideload apps, you will need to enable this in the system settings under “For Developers”. Be sure to either have developer mode, or sideload apps selected
For Linux Distro Maintainers
To submit to the Store, you will need to work with us to receive publishing approval. If you are a Linux distribution owner interested in adding your distribution to the Microsoft Store, please contact email@example.com.
Follow the instructions on the Distro Launcher GitHub repo to create a custom Linux distro package.
- Open Sourcing a WSL Sample for Linux Distribution Maintainers and Sideloading Custom Linux Distributions
- Command-Line blog
Send feedback about: