You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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>
Copy file name to clipboardExpand all lines: WSL/setup/environment.md
+6-7Lines changed: 6 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
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
5
5
ms.topic: how-to
6
6
no-loc: [Terminal]
7
7
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
15
15
16
16
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.
17
17
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
-
22
18
Open PowerShell (or Windows Command Prompt) and enter:
23
19
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
+
24
23
```powershell
25
24
wsl --install
26
25
```
@@ -127,7 +126,7 @@ We recommend using Visual Studio Code or Visual Studio, as they directly support
127
126
128
127
### Use Visual Studio Code
129
128
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.
131
130
132
131
Once VS Code is installed and set up, you can open your WSL project with a VS Code remote server by entering: `code .`
0 commit comments