This repository contains a setup script doing the initial setup of the Windows Subsystem for Linux. After the installtion you will be provided with a functioning Ubuntu installation able to launch applications with a GUI. The windows of the applications running within Ubuntu seamlessly integrate within your Windows System. During the setup process the script prints short descriptions about what the setup is doing in each particular setup step.

Usage

1. Install Ubuntu
2. Download the script
3. Optional but strongly recommended: This script uses admin permissions, thus the script has the permission to alter your system files. For that reason you should ensure that the files you have downloaded have not been altered.
   1. Open the directory containing the downloaded zip file in the explorer
   2. Hold shift and right click on to the white space next to the listed files
   3. Click on the context menu entry Start Powershell here
   4. Enter the following command: Get-FileHash .\wsl-onboarding.zip -Algorithm MD5
   5. Compare the output with this hash (can be opened with a texteditor)
   6. IF THE HASHES DO NOT MATCH DON'T RUN THE SCRIPT. IT HAS BEEN ALTERED AND IS MAYBE CONTAINING MALICIOUS CODE.
4. Extract the zip archive
5. Open the extracted directory, right click on run-setup.ps1 and click on Run with Powershell

Work in Progress

This project uses libraries from https://github.com/jason076/script-libs

Contributing

Further Reading