Hi folks!

Today, I will explain to you how to configure WSL 2 on Windows to have a fully programming environment with productivity in mind. In this post, I will show you how to configure WSL 2 to fully integrate it with VS Code and Docker Desktop.

In case you missed it, in a [previous post](https://aalonso.dev/blog/how-to-install-wsl2-on-windows-10-5e82) I explained how to install WSL2 on your Windows 10 machine. 

## Wait, can you really be a productive programmer in Windows?

Yes, or at least, WSL 2 will provide you with a Linux environment with all the fancy stuff such as a UNIX terminal (bash, zsh, ...), unix tools like curl, wget, ssh, ..., and everything you would need in a normal development environment, while still having a Windows OS where you can install some proprietary Windows-only apps.

**This is how I configured my PC for my daily remote work as a professional programmer.** Before that, I had a dual boot windows + Linux setup, which I encourage you to do if you want to enjoy the fully Linux experience. However, currently I prefer and easier approach, as I use a lot of apps that can only be installed on Windows along with some games with only Windows support, and I don't want to maintain two different OSes, nor having my disk space divided or a boot manager asking me what to boot.

## First step: installing docker

To install docker on both Windows and WSL 2 you only need to install Docker Desktop with its .exe installer. That's it. Here is the official download URL:

https://www.docker.com/products/docker-desktop

Install it like any other Windows app. If it asks about enabling WSL2 support, just select it like in the picture below:

![Installing Docker Desktop with WSL 2 support](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/j2xirsv0tn2z3ln8mi36.png)

Once installed, open the Docker Desktop app and go to settings by clicking on the gear icon on the upper bar (1). Then, check if effectively WSL 2 support is enabled (2). Also, there you can disable Docker Desktop to automatically start when you log in to Windows, or to send usage statistics if you want.

![Checking WSL 2 support on Docker](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/gdpwb3be129futrhucvp.png)

If you have more than one Linux distribution installed on WSL 2, you may want to enable Docker for them as well. To do so, just go `Resources > WSL integration` as you see in the picture below.
 
![Enabling WSL for individual distros](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/qejtne1sdj9x33cyjxd7.png)

After that, maybe restarting Docker and WSL is required. You can just reboot your Windows PC, or manually:

1. Right-clicking on the docker icon on task bar --> Restart Docker
2. Open a PowerShell terminal and type `wsl --shutdown`

### Testing and troubleshooting

You can test your Docker integration with WSL by running the following commands from WSL 2:

```sh
docker --version
docker-compose --version
```

If everything is correctly configured, those commands will show your docker installed version. 

However, if it prints an error message saying that the `docker` or `docker-compose` command couldn't be found, check that the Docker Desktop app is up and running by looking for the Docker icon on the Windows task bar. If Docker is running and the error persists, you should double-check that you enable WSL2 integration on Docker Desktop settings, like in the pictures above. Try enabling it on all your Linux distros by activating the toggle button on `Resources > WSL integration` settings page or restarting your PC if you didn't do it already.

## Next: installing VS Code Remote WSL extension

I suppose you already have installed the good knowing VS Code editor on your Windows. If you haven't done it yet, just [download it from the official page](https://code.visualstudio.com/download) and install it like any other Windows program. There is nothing especial with its installation process.

Then, open VS Code and install the [Remote WSL extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl). On the extension's page, you can read about what this extension does and how to use it.

Once the extension is installed and enabled, on VS Code press `Ctrl + Shift + P` and search for `wsl` commands. You should be able to see commands for opening a folder inside your WSL distro or just opening a new VS Code instance on your home directory, like in the next picture.

![WSL commands from VS Code](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/1dbik1uyauagebbemw7s.png)

If executing one of the above commands, you should be now using VS Code over a WSL folder. If you try to open the VS Code integrate terminal, you will load bash (or zhs or whatever your default distro shell is it) instead of PowerShell or CMD. You are, effectively, working inside your WSL environment.

Pro-tip: you can open a VS Code instance from/in a WSL directory by just typing on the WSL terminal:
```sh
code . 
```

## Conclusions

Congratulations! Now you have a fully working dev environment with VS Code, fully integrated with Docker and with your favorite Linux shell and tools available. In fact, you are working on a near-to-full Linux distribution without leaving Windows, so Linux specific tools, configurations and project setups will work out of the box inside WSL.

With this setup, it is easy to feel productive programming on Windows!

Hi folks!  Today, I will explain to you how to configure WSL 2 on Windows to have a fully programming...

How to be a productive programmer in Windows with WSL2

Aitor Alonso

Hi guys!

This is the first post of a series that aims to explain how to get a fully productive and integrated Linux development environment within Windows 10. Today, I will explain what is WSL 2 and how to install it on Windows.

## What is WSL 2?

But first what it's first. What is WSL 2? The Windows Subsystem for Linux (WSL) lets developers run a GNU/Linux environment -- including most command-line tools, utilities, and applications such as bash, ssh, sudo, apt, curl, etc. -- directly on Windows, unmodified, without the overhead of a traditional virtual machine or the extra disk space needed for a dual boot setup.

WSL 2 is a new version of the Windows Subsystem which primary goals are to increase file system performance, as well as adding full system call compatibility. The Linux kernel is executing in parallel to the Windows one, in a very light hypervisor (a low resource consuming virtual machine).

If you are interested in learning more about what is WSL and what does, along with the differences between version 1 and 2, you can check the [official Microsoft docs](https://docs.microsoft.com/en-us/windows/wsl/compare-versions).

## Enabling WSL on your Windows

First, your Windows 10 build version should be 1903 (also known as 19H1) or above. This is a version from May 2019, so if you have auto updates enables, it is highly probable that you are using a compatible Windows 10 build.

If you want to check what your current Windows 10 build version is, just run `winver` and a window will open with the basic version info.

![How to know what is your Windows 10 build version](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/kxq6fb4s3032x7bh2b2t.png)

Next, we will enable the WSL feature on our Windows. For doing that, open a new PowerShell instance as administrator. Just search for `powersell` and `right click -> execute as administrator`. There, we will execute the following command:

```powershell
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
```

Now, we must enable the Virtual Machine Platform feature to WSL for proper working, by executing:

```powershell
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
```

At this point we should restart our Windows to apply changes. Once we are back in our user, we need to set WSL version 2 as our default WSL version. For doing that, open a new PowerShell terminal (doesn't need to be an administrator privileged terminal) and execute the following command:

```powershell
wsl --set-default-version 2
```

## Installing your Linux distribution

Congratulations!`You have already installed WSL 2 in your machine. It wasn't so difficult, wasn't it? Just a few terminal commands.

The next step is to install your Linux distribution of choice. To do so, just open the Microsoft Store app on your Windows and search for `linux`.

![Linux's distributions available for WSL](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/p8ra7kehwzsi8b8z16ow.png)

Personally, I installed Ubuntu for the following **subjective** reasons:
- Canonical (the developers of Ubuntu) and Microsoft have a partnership to ensure maximum stability and compatibility of the Ubuntu WSL images.
- Most of Linux user out there use Ubuntu, so it is easy to find resolution to the majority of problems, because chances are that someone had the same problem before you.
- As a developer (my Linux geek times went away years ago) I want to expend the less time possible solving problems with my environment, so the above two points are important to me.

However, you can use, as I said, the distro of your choice. I will use Ubuntu for the rest of the series, but the steps should be equal or very similar to all the WSL available Linux distributions. Just chose one and select "Get" on the Store.

![Ubuntu for WSL on Microsoft Store](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/zdneeb36hdzbnyf7z8xd.png)

The first time you launch a newly installed Linux distribution, a console window will open, and you'll be asked to wait for a minute or two for files to decompress and be stored on your PC. All future launches should take less than a second.

You will then need to create a user account and password for your new Linux distribution. This will be a user with sudo privileges. The onboarding script will guide you through this process, but if you have some doubts or want to know more, here is the [official Microsoft docs](https://docs.microsoft.com/en-us/windows/wsl/user-support) that explain it very well.

Hope you have found this post useful. Cheers!

Hi guys!  This is the first post of a series that aims to explain how to get a fully productive and i...

How to install WSL2 on Windows 10

Hello Dev community!

Years ago I started my first personal side project as a new and funny way of learning new technologies and methodologies. I remember that choosing an idea, a programming language and a framework was easy as there were some that got my attention and wanted to dive deeper into them.

However, when I had my project ready for production, and I started to read about how to deploy it, I got overwhelmed with all the existing ways of doing that. From PaaS to IaaS (terms that were unknown to me) to the different vendors and free products that suits each classification.

So that is why now, as a more experienced developer, I wrote an article telling about **what are IaaS and PaaS** where I tell **how to deploy an app to the web** by comparing five of the most known PaaS providers and their free products: **Netlify, Vercel, Heroku, GitHub Pages** and **Firebase**.

It's something I'd like to have found when I was starting: a good basis for novice developers and a good memory refresh for most experienced ones.

I hope you find it useful!

https://acidtango.com/thelemoncrunch/how-to-deploy-a-full-stack-app-to-the-web/

Hello Dev community!  Years ago I started my first personal side project as a new and funny way of le...

I'm Aitor 👋

Latest Articles

How to be a productive programmer in Windows with WSL2

How to install WSL2 on Windows 10

How to Deploy a Full-Stack App to the Web