explaingit

microsoft/wsl

📈 Trending32,320C++Audience · developerComplexity · 4/5ActiveLicenseSetup · hard

TLDR

Run a real Linux environment directly on Windows without a virtual machine, letting developers use Linux tools while staying in Windows.

Mindmap

mindmap
  root((repo))
    What it does
      Run Linux on Windows
      Access Linux tools natively
      Share files between OS
    How it works
      Lightweight kernel VM
      Full system compatibility
      Near-native performance
    Use cases
      Developer workflows
      Build systems
      Server applications
    Related features
      WSLg graphical apps
      Package managers
      Shell scripting

Things people build with this

USE CASE 1

Run bash scripts and Linux command-line tools on a Windows machine without leaving your workflow.

USE CASE 2

Use Linux-native build systems and compilers to develop software that targets Linux servers.

USE CASE 3

Follow Linux-based tutorials and documentation by running the exact same commands on your Windows PC.

USE CASE 4

Access Linux package managers and development environments while keeping Windows as your primary OS.

Tech stack

C++Linux kernelWindowsPowerShell

Getting it running

Difficulty · hard Time to first run · 1day+

Requires building from C++ source, kernel integration, and complex Windows/Linux interop setup.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice and license text.

In plain English

Windows Subsystem for Linux (WSL) is a feature built by Microsoft that lets you run a real Linux environment directly on a Windows computer, without needing a separate virtual machine or setting up a dual-boot system where you pick either Windows or Linux at startup. The problem it solves is that many developers, data scientists, and system administrators need to use Linux tools, commands, and utilities, but they also need Windows for their main workflow. Before WSL, the only ways to do this were cumbersome: use a virtual machine (which is slow and resource-heavy), buy a separate Linux machine, or abandon Windows entirely. WSL works by integrating the Linux kernel directly into Windows. The second version, WSL 2, runs an actual Linux kernel in a lightweight, highly optimized virtual machine that Microsoft controls, giving near-native performance and full system call compatibility. This means you can run unmodified Linux software, command-line tools, shell scripts, compilers, package managers, server applications, as if you were on a real Linux machine. Files on your Windows drives are accessible from Linux, and vice versa, so the two environments work together rather than in isolation. A related project called WSLg also brings support for graphical Linux applications, meaning you can run Linux programs with windows and UI elements directly on your Windows desktop. You would use WSL if you are a developer on a Windows machine who needs access to Linux tooling, for example, running bash scripts, using Linux-native build systems, or following tutorials written for Linux environments. Installation is as simple as running one command in Windows PowerShell. The codebase is primarily written in C++ and this repository is the official open-source home of the WSL project maintained by Microsoft.

Copy-paste prompts

Prompt 1
How do I install WSL 2 on my Windows machine and set up a Linux distribution?
Prompt 2
Show me how to access my Windows files from within WSL and run a bash script.
Prompt 3
What are the differences between WSL 1 and WSL 2, and which should I use?
Prompt 4
How do I run graphical Linux applications on Windows using WSLg?
Prompt 5
Help me set up a development environment in WSL for building Node.js or Python projects.
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.