Skip to content
An in-depth Guide for getting started with the Windows Subsystem for Linux!
Branch: master
Clone or download
Latest commit 58cc4e6 Jul 8, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
readmes Update Jul 7, 2019
LICENSE Initial commit May 8, 2018 Update May 8, 2019

Windows Subsystem for Linux Setup


WSL 2 is out! I have not had a chance to look at it yet, but I expect that this guide will need another round of updates to account for these changes!

The section that talks about permissions is incorrect. Please look at the issues tab for more information.

An in-depth guide for developers on how to get started with the Windows Subsystem for Linux.

Microsoft and Linux

The Windows Subsystem for Linux feature on Windows 10 enables users to have a Linux enviroment fully integrated into their Windows PC.

For experienced all developers: This is not a VM, a Dual-boot, or a console wrapper like Git Bash or Cygwin. It is a native POSIX environment directly mounted to your Windows File System.

Video Guide:

This guide also has a video walkthrough of it on YouTube where it goes into great detail on each section to help provide you with as much context as possible.

It's recommended you watch the videos while you go through this guide as they will help clairify many of these points with visuals.

Link to the WSL Video Playlist.

Windows Subsystem for Linux Part One: Introduction into WSL

What this guide covers

By the end of this guide, you will know:

  1. What WSL is, and why it's important.
  2. How to install WSL and the free Ubuntu App.
  3. How the two file systems work together, and how you should work with them.
  4. How to update your terminal, and edit WSL files.
  5. Where, why, and how to install different programs and software.
  6. Additional important information.


Use This Checklist to help keep track of your progress! It makes use of Local Storage to maintain your progress even if you close the Window. Note: CTRL + CLICK to open in a new window!

There is also a challenge at the bottom designed to help you learn more about the work-flow as well.

Ready to begin?

Go to Page 1: Introduction into WSL

You can’t perform that action at this time.