|
| 1 | +--- |
| 2 | +title: Build a Custom Linux Distro for WSL |
| 3 | +description: Learn how to create a custom Linux distribution for WSL. |
| 4 | +keywords: BashOnWindows, bash, wsl, windows, windowssubsystem, distro, custom |
| 5 | +author: taraj |
| 6 | +ms.author: taraj |
| 7 | +ms.date: 3/27/2018 |
| 8 | +ms.topic: article |
| 9 | +ms.prod: windows-subsystem-for-linux |
| 10 | +ms.service: windows-subsystem-for-linux |
| 11 | +ms.assetid: a5095219-0c82-4ce5-9a6d-5c2fc00835a3 |
| 12 | +--- |
| 13 | + |
| 14 | +# Creating a Custom Linux Distro for WSL |
| 15 | + |
| 16 | +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](https://github.com/Microsoft/WSL-DistroLauncher) on GitHub. |
| 17 | + |
| 18 | +This project enables: |
| 19 | +* Linux distribution maintainers to package and submit a Linux distribution as an appx that runs on WSL |
| 20 | +* Developers to create custom Linux distributions that can be sideloaded onto their dev machine |
| 21 | + |
| 22 | +## Background |
| 23 | +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. |
| 24 | + |
| 25 | +## Sideloading a Custom Linux Distro Package |
| 26 | +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. |
| 27 | +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 |
| 28 | + |
| 29 | +## For Linux Distro Maintainers |
| 30 | +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 protected]. |
| 31 | + |
| 32 | +## Getting Started |
| 33 | +Follow the instructions on the [Distro Launcher GitHub repo](https://github.com/Microsoft/WSL-DistroLauncher) to create a custom Linux distro package. |
| 34 | + |
| 35 | + |
| 36 | +## Team Blogs |
| 37 | +* [Open Sourcing a WSL Sample for Linux Distribution Maintainers and Sideloading Custom Linux Distributions](https://blogs.msdn.microsoft.com/commandline/2018/03/26/wsl-distro-launcher/) |
| 38 | +* [Command-Line blog](https://blogs.msdn.microsoft.com/commandline/) |
| 39 | + |
| 40 | +## Provide Feedback |
| 41 | +* [Distro Launcher Gitub repo](https://github.com/Microsoft/WSL-DistroLauncher) |
| 42 | +* [GitHub issue tracker for WSL](https://github.com/Microsoft/BashOnWindows/issues) |
| 43 | +* [Command-line UserVoice portal](https://wpdev.uservoice.com/forums/266908-command-prompt-console-bash-on-ubuntu-on-windo/category/161892-bash) |
0 commit comments