Skip to content

Commit c37ce3a

Browse files
Remove outdated Build 20262+ requirement; update VS Code extension link
* Remove outdated Build 20262+ requirement; update VS Code extension recommendation - Remove 'must be running Build 20262+' note — all supported Windows 10/11 versions exceed this 2020 Insider build requirement; the note adds noise without value. Retained the link to the WSL installation page as a note for users wanting a different distro or manual steps. - Update VS Code recommendation: point to the standalone WSL extension (ms-vscode-remote.remote-wsl) instead of the full Remote Development extension pack, consistent with current VS Code docs and PR #2517. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Address Copilot review: fix typo, add correct wsl --install prerequisite - Fix 'set-by-step' typo in front-matter description - Add correct Windows prerequisite for wsl --install: version 2004 (Build 19041+) or Windows 11 — replacing the removed Build 20262+ note which cited an Insider-only build number Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 6098a69 commit c37ce3a

1 file changed

Lines changed: 6 additions & 7 deletions

File tree

WSL/setup/environment.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Set up a WSL development environment
3-
description: Set up a WSL development environment using best practices from this set-by-step guide. Learn how to run Ubuntu, Visual Studio Code or Visual Studio, Git, Windows Credential Manager, MongoDB, MySQL, Docker remote containers and more.
4-
ms.date: 11/20/2023
3+
description: Set up a WSL development environment using best practices from this step-by-step guide. Learn how to run Ubuntu, Visual Studio Code or Visual Studio, Git, Windows Credential Manager, MongoDB, MySQL, Docker remote containers and more.
4+
ms.date: 04/16/2026
55
ms.topic: how-to
66
no-loc: [Terminal]
77
ms.custom: seo-windows-dev
@@ -15,12 +15,11 @@ A step-by-step guide to the best practices for setting up a WSL development envi
1515

1616
Windows Subsystem for Linux comes with the Windows operating system, but you must enable it and install a Linux distribution before you can begin using it.
1717

18-
To use the simplified --install command, you must be running a recent build of Windows (Build 20262+). To check your version and build number, select **Windows logo key + R**, type **winver**, select **OK**. You can update using the [Settings menu](ms-settings:windowsupdate) or [Windows Update Assistant](https://www.microsoft.com/software-download/).
19-
20-
If you prefer to install a Linux distribution other than Ubuntu, or would prefer to complete these steps manually, see the [WSL installation page](../install.md) for more details.
21-
2218
Open PowerShell (or Windows Command Prompt) and enter:
2319

20+
> [!NOTE]
21+
> The `wsl --install` command requires Windows 10 version 2004 (Build 19041) or later, or Windows 11. If you prefer to install a different Linux distribution, or would prefer to complete these steps manually, see the [WSL installation page](../install.md) for more details.
22+
2423
```powershell
2524
wsl --install
2625
```
@@ -127,7 +126,7 @@ We recommend using Visual Studio Code or Visual Studio, as they directly support
127126

128127
### Use Visual Studio Code
129128

130-
Follow this step-by-step guide to [Get started using Visual Studio Code with WSL](../tutorials/wsl-vscode.md), which includes installing the [Remote Development extension pack](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack). This extension enables you to run WSL, SSH, or a development container for editing and debugging with the full set of Visual Studio Code features. Quickly swap between different, separate development environments and make updates without worrying about impacting your local machine.
129+
Follow this step-by-step guide to [Get started using Visual Studio Code with WSL](../tutorials/wsl-vscode.md), which includes installing the [WSL extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl). This extension enables you to use WSL as a full-featured development environment directly from VS Code. Quickly swap between different, separate development environments and make updates without worrying about impacting your local machine.
131130

132131
Once VS Code is installed and set up, you can open your WSL project with a VS Code remote server by entering: `code .`
133132

0 commit comments

Comments
 (0)