Skip to content

Commit dbe4a9c

Browse files
Tara Rajscooley
authored andcommitted
Adding doc for custom distro creation (#178)
* Adding doc for custom distro creation * Added GUID
1 parent a841465 commit dbe4a9c

2 files changed

Lines changed: 44 additions & 0 deletions

File tree

WSL/TOC.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@
44
# [User accounts and permissions](./user-support.md)
55
# [Distro management](./wsl-config.md)
66
# [Interoperability](./interop.md)
7+
# [Build a Custom Distro](./build-custom-distro.md)
78
# [Frequently Asked Questions](./faq.md)
89
# [Troubleshooting](./troubleshooting.md)
910
# [Release Notes](./release-notes.md)

WSL/build-custom-distro.md

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
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

Comments
 (0)