Windows: WSL

Setting up the Windows Subsystem for Linux (WSL)

For advanced users who are looking to have a full Linux command-line interface on their Windows machine, we recommend using Windows Subsystem for Linux (WSL). This will allow you to access package managers (such as apt-get for Ubuntu/Debian) and the full suite of UNIX commands.

The first step is ensuring that you have a compatible machine. You will need:

The following guides from Microsoft detail the installation instructions for WSL and WSL 2 respectively. We recommend WSL 2 if your Windows 10 build supports it.

For users who want a nicer looking terminal, complete with tabs, emojis, and more customization features, you can optionally install the new Windows Terminal (Preview) from the Microsoft Store.

Keep in mind that WSL uses UNIX line endings (LF) while Windows uses CRLF line endings. If you checked out your code natively in Windows (i.e. using Git Bash or GitHub Desktop), your Git repository may be using CRLF line endings, and therefore may cause Shell scripts (and other programs that parse based on line endings) and Git commits to act differently or fail.

Related topics:

  • Windows: WSL—Setting up the Windows Subsystem for Linux (WSL)