> ## Content Index > Fetch the complete content index at: https://www.jonathancreamer.com/llms.txt > Use this file to discover other available public pages before exploring further. # Setting up WSL2 and the VSCode Remote Containers WSL Plugin - URL: https://www.jonathancreamer.com/setting-up-wsl2-and-the-vscode-containers-plugin/ - Published: 2021-09-13T17:11:52.000Z - Updated: 2024-01-05T16:26:17.000Z - Author: Jonathan Creamer - Tags: docker, vscode, wsl For years, macOS has been the gold standard for tooling when it comes to Web Development. The unix basis of macOS, iTerm, bash, VIM, etc are all things that folks building for the web platform rely on day to day. That all changes with WSL2. WSL2 allows web dev folks working in Windows to get the same goodness of macOS's unix based tooling running "more natively" on Windows. Read more about how all this works: - [Docker ❤️ WSL 2 - The Future of Docker Desktop for Windows - Docker Blog](https://www.docker.com/blog/docker-hearts-wsl-2/?ref=jonathancreamer.com) - [Introducing the Docker Desktop WSL 2 Backend - Docker Blog](https://www.docker.com/blog/new-docker-desktop-wsl2-backend/?ref=jonathancreamer.com) UPDATE: 1-5-24 ## Steps to install WSL2 (The Windows 11 way) ### Step 1 ```bash wsl --install ``` THAT IS LITERALLY IT You can also watch this video I recorded about WSL and Javascript... ## Steps to install WSL2 (The old way) ### Step 1 Turn on WSL in a command prompt or Powershell. ``` dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart ``` ### Step 2 Enable the Virtual Machine Platform ``` dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart ``` Probably should restart after this. ### Step 3 Install this [X64 Patch](https://wslstorestorage.blob.core.windows.net/wslblob/wsl%5Fupdate%5Fx64.msi?ref=jonathancreamer.com). ### Step 4 Make sure WSL2.0 is default. ``` wsl --set-default-version 2 ``` ### Step 4 Install Linux! Go to the [Windows Store](https://aka.ms/wslstore?ref=jonathancreamer.com), and find your favorite Linux. e.g. [Ubuntu 20](https://www.microsoft.com/store/apps/9n6svws3rx71?ref=jonathancreamer.com), [Alpine Linux](https://www.microsoft.com/store/apps/9p804crf0395?ref=jonathancreamer.com) ### Optional other good stuff That's it for WSL2 install, but there's more goodness you can get with... ### Install Windows Terminal [Windows Terminal](https://www.microsoft.com/en-us/p/windows-terminal/9n0dx20hk701?ref=jonathancreamer.com) is a brilliant app that manages all kinds of command prompts, terminals, etc. Read more about how to make [Powershell Pretty](https://www.jonathancreamer.com/making-powershell-pretty/). ![](https://storage.ghost.io/c/42/63/4263df8f-a33f-403d-aa31-ba113a54d1b7/content/images/2021/09/image-1.png) By default it will work with Command Prompt and Powershell, but once you have WSL, and Linux installed, it'll also allow you to open Terminals straight into your Linux! ### Install Docker Desktop (optional) If you use Docker on Windows, installing [Docker Desktop](https://www.docker.com/products/docker-desktop?ref=jonathancreamer.com) allows you to install a new WSL2 based backend that speeds up working with Docker on Windows, adds a nice GUI on top of Docker that allows you to see your running containers visually, installs all the command line tools for docker like docker-compose, and allows you to install a small kubernetes cluster as well. ![](https://storage.ghost.io/c/42/63/4263df8f-a33f-403d-aa31-ba113a54d1b7/content/images/2021/09/image-2.png) Read more [here](https://docs.docker.com/desktop/windows/wsl/?ref=jonathancreamer.com). ## VSCode Remote Containers ### Step 1 Install the [Remote Containers - WSL](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl&ref=jonathancreamer.com) plugin. ### Step 2 Clone a Repo, or something in your Linux Distro. Note, don't clone into the `/mnt/C` directory anywhere, that's a built in way for your WSL instance to interact with your `c:` drive, but it's tremendously slow. Make sure you go to `cd ~` or somewhere on the WSL drive before cloning. ![](https://storage.ghost.io/c/42/63/4263df8f-a33f-403d-aa31-ba113a54d1b7/content/images/2021/09/image-3.png) ### Step 3 You can `cd /path/to/clone`, and run `code .`, or... Use the Command Palette (Control + Shift + P) and search for Remote-WSL to Open a Folder. ![](https://storage.ghost.io/c/42/63/4263df8f-a33f-403d-aa31-ba113a54d1b7/content/images/2021/09/image-4.png) Choose the folder you want, and VSCode will now open the project connected directly to your Linux Distro. ![](https://storage.ghost.io/c/42/63/4263df8f-a33f-403d-aa31-ba113a54d1b7/content/images/2021/09/image-5.png) Alternatively you can navigate to the repo in Terminal, and use `code .` which will also open VSCode connected directly to the Linux Distro. ## Conclusion This post tried to be as clear and concise along the way to get up and running with WSL2 and VSCode as quick as possible. It's a huge productivity win for Web Dev folks working on Windows to be able to develop against Linux, so hopefully this will help accelerate those gains. ## BONUS PROTIP You can also install the [Remote - Containers ](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers&ref=jonathancreamer.com)plugin and test out different programming languages with the power of Docker. ![](https://storage.ghost.io/c/42/63/4263df8f-a33f-403d-aa31-ba113a54d1b7/content/images/2021/09/image-7.png) ![](https://storage.ghost.io/c/42/63/4263df8f-a33f-403d-aa31-ba113a54d1b7/content/images/2021/09/image-6.png)