> For the complete documentation index, see [llms.txt](https://docs.eclipse.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eclipse.xyz/developers/tutorials-and-guides/developer-guides/dapp-deployment-tutorial-eclipse-devnet/install-dependencies-windows/step-7-install-wsl-on-visual-studio-code-and-upgrade-to-wsl2.md).

# Step 7: Install WSL on Visual Studio Code and Upgrade to WSL2

The Windows Subsystem for Linux (WSL) allows you to run a Linux environment directly on Windows, without the overhead of a traditional virtual machine or dual-boot setup. Installing WSL and upgrading to WSL2 enhances performance and supports full system call compatibility, which is crucial for development tasks.

**Install WSL on Visual Studio Code**

1. **Enable WSL on Windows**:
   * Before installing a Linux distribution, you must enable the Windows Subsystem for Linux feature. Open PowerShell as Administrator and run:

     ```powershell
     dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
     ```
2. **Install Your Linux Distribution of Choice (Ubuntu)**:
   * Open the Microsoft Store and search for Ubuntu. Select the version you wish to install (e.g., Ubuntu 20.04 LTS) and click "Get" to install it.<br>

     <figure><img src="https://lh7-us.googleusercontent.com/yY_Oe5uhq2UlEK0QzWStLQprwsFabLzT3hOhUSOak2AVAlK0GwwrBYqe7twngpZyftIePQmo36Cz_cqgvnRi_afFfjZzCKsLo1tj94Btqg_nS3IOt1JANIvEGYiRYOG-eu-eQXLbPxRxOvgQerCHCLk" alt=""><figcaption></figcaption></figure>
   * Once installed, launch Ubuntu from the Start menu, and you'll be prompted to create a user account and password.<br>

     <figure><img src="https://lh7-us.googleusercontent.com/f4ekncPDoKbr4Klpugoxa3jpAgwkv5iY1u2dzsDYHd5dAs4eVyF9RM_4TG1XCbBdYeGfwgS-Vx5iQQrBbYuxSRCKsohLkcONENL9j2NDBCprXnO4KbGwrbvN1Hf7IfUjNUy8hfcdEf-L16WLnvjmDTA" alt=""><figcaption><p>Example Output</p></figcaption></figure>

**Upgrade to WSL2**

1. **Ensure Your System Supports WSL2**:
   * WSL2 requires Windows 10 version 1903 or higher. Ensure your Windows is up to date.
2. **Download the Linux Kernel Update Package**:
   * Follow the instructions at [Microsoft's official guide](https://learn.microsoft.com/en-us/windows/wsl/install-manual#step-4---download-the-linux-kernel-update-package) to download and install the Linux kernel update package for WSL2.
3. **Set WSL2 as Your Default Version**:
   * Open PowerShell as Administrator and run:

     ```powershell
     wsl --set-default-version 2
     ```
   * This command sets WSL2 as the default version for any future Linux distribution installations.
4. **Verify Installation**:
   * To confirm that WSL2 is installed and running, you can open your Linux distribution (e.g., Ubuntu) and run:

     ```bash
     uname -a
     ```
   * This command should display a Linux kernel version indicating that WSL2 is actively running.

**Install WSL Extension in VSC**

* **Navegate to "Extensions" tab in VSC and search for "WSL"; install the extension:**

<figure><img src="https://lh7-us.googleusercontent.com/yMwisx6N6GyWiLk6AlO5LkHevOHAnGb8NHqaj3aq1hM9Q-wemZODHc36WTdAqOmh4gM8WKHrv6vEquwyaGbqaCHhYEND4jQR6Lep-Jusu4mKD0dHpXongcCfKMX_D_2Uhe4IUzufzEJj9mYkYH7oRk8" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.eclipse.xyz/developers/tutorials-and-guides/developer-guides/dapp-deployment-tutorial-eclipse-devnet/install-dependencies-windows/step-7-install-wsl-on-visual-studio-code-and-upgrade-to-wsl2.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.