Skip to content

Commit 223da51

Browse files
Update stale WSL + VS Code and install-on-server pages
wsl-vscode.md (last reviewed 2021): - Recommend WSL extension directly; mention Remote Development pack as optional alternative - Remove outdated VS Code 1.35 minimum version requirement callout - Replace deprecated Shan.code-settings-sync community extension with VS Code built-in Settings Sync - Remove 'new' from Windows Terminal (pre-installed on Windows 11); fix profile.json -> settings.json - Remove deprecated RTVS (R Tools for Visual Studio) link install-on-server.md (last reviewed 2022): - Expand Server 2022/2025 section heading; add Server 2025 link and note Server Core 2025 support - Add wsl --update as the modern kernel update method for Server 2022+; clarify MSI is for Server 2019 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 33db75e commit 223da51

2 files changed

Lines changed: 16 additions & 14 deletions

File tree

WSL/install-on-server.md

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,23 @@
11
---
22
title: Install Linux Subsystem on Windows Server
33
description: Learn how to install the Linux Subsystem on Windows Server. WSL is available for installation on Windows Server 2019 (version 1709) and later.
4-
ms.date: 06/14/2022
4+
ms.date: 04/15/2026
55
ms.topic: install-set-up-deploy
66
---
77

88
# Windows Server Installation Guide
99

1010
The Windows Subsystem for Linux (WSL) is available for installation on Windows Server 2019 (version 1709) and later. This guide will walk through the steps of enabling WSL on your machine.
1111

12-
## Install WSL on Windows Server 2022 and 2025 Desktop Experience
12+
## Install WSL on Windows Server 2022 and 2025
1313

14-
[Windows Server 2022](/windows-server/get-started/whats-new-in-windows-server-2022) now supports a simple WSL installation using the command:
14+
[Windows Server 2022](/windows-server/get-started/whats-new-in-windows-server-2022) and [Windows Server 2025](/windows-server/get-started/whats-new-in-windows-server-2025) support a simple WSL installation using the command:
1515

1616
```powershell
1717
wsl.exe --install
1818
```
1919

20-
You can now install everything you need to run WSL on Windows Server 2022 by entering this command in an **administrator** PowerShell and then restarting your machine.
20+
You can now install everything you need to run WSL on Windows Server 2022 or 2025 (including Server Core on 2025) by entering this command in an **administrator** PowerShell and then restarting your machine.
2121

2222
This command will enable the required optional components, download the latest Linux kernel, set WSL 2 as your default, and install a Linux distribution for you *(Ubuntu by default)*.
2323

@@ -46,7 +46,13 @@ Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-L
4646

4747
### Install the WSL Kernel update for WSL 2
4848

49-
This is not necessary for server core 2025.
49+
> [!NOTE]
50+
> This step is only needed for Windows Server 2019. On Server 2022 and later, use `wsl --update` instead:
51+
> ```powershell
52+
> wsl --update
53+
> ```
54+
55+
For Windows Server 2019, you can install the WSL 2 kernel update using the MSI package:
5056
5157
```powershell
5258
Invoke-WebRequest -Uri "https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi" -OutFile ".\wsl_update_x64.msi"

WSL/tutorials/wsl-vscode.md

Lines changed: 5 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Get started using VS Code with WSL
33
description: Learn how to set up VS Code to author and debug code using the Windows Subsystem for Linux.
44
keywords: wsl, windows, windowssubsystem, gnu, linux, bash, vs code, remote extension, debug, path, visual studio
5-
ms.date: 09/27/2021
5+
ms.date: 04/15/2026
66
ms.topic: get-started
77
---
88

@@ -25,10 +25,7 @@ Visual Studio Code, along with the WSL extension, enables you to use WSL as your
2525

2626
* When prompted to **Select Additional Tasks** during installation, be sure to check the **Add to PATH** option so you can easily open a folder in WSL using the code command.
2727

28-
* Install the [Remote Development extension pack](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack). This extension pack includes the WSL extension, in addition to the Remote - SSH, and Dev Containers extensions, enabling you to open any folder in a container, on a remote machine, or in WSL.
29-
30-
> [!IMPORTANT]
31-
> In order to install the WSL extension, you will need the [1.35 May release](https://code.visualstudio.com/updates/v1_35) version or later of VS Code. We do not recommend using WSL in VS Code without the WSL extension as you will lose support for auto-complete, debugging, linting, etc. Fun fact: this WSL extension is installed in $HOME/.vscode/extensions (enter the command `ls $HOME\.vscode\extensions\` in PowerShell).
28+
* Install the [WSL extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl). If you also plan to work with remote machines or Dev Containers, you can install the [Remote Development extension pack](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack) instead, which includes the WSL extension along with Remote - SSH and Dev Containers.
3229

3330
## Update your Linux distribution
3431

@@ -86,11 +83,11 @@ To install Git, see [set up Git to work with Windows Subsystem for Linux](./wsl-
8683

8784
## Install Windows Terminal (optional)
8885

89-
The new Windows Terminal enables multiple tabs (quickly switch between Command Prompt, PowerShell, or multiple Linux distributions), custom key bindings (create your own shortcut keys for opening or closing tabs, copy+paste, etc.), emojis ☺, and custom themes (color schemes, font styles and sizes, background image/blur/transparency). Learn more in the [Windows Terminal docs](/windows/terminal).
86+
Windows Terminal enables multiple tabs (quickly switch between Command Prompt, PowerShell, or multiple Linux distributions), custom key bindings (create your own shortcut keys for opening or closing tabs, copy+paste, etc.), emojis ☺, and custom themes (color schemes, font styles and sizes, background image/blur/transparency). Windows Terminal comes pre-installed on Windows 11. Learn more in the [Windows Terminal docs](/windows/terminal).
9087

9188
1. Get [Windows Terminal in the Microsoft Store](https://apps.microsoft.com/detail/9N0DX20HK701): By installing via the store, updates are handled automatically.
9289

93-
2. Once installed, open Windows Terminal and select **Settings** to customize your terminal using the `profile.json` file.
90+
2. Once installed, open Windows Terminal and select **Settings** to customize your terminal using the `settings.json` file.
9491

9592
## Additional Resources
9693

@@ -99,9 +96,8 @@ The new Windows Terminal enables multiple tabs (quickly switch between Command P
9996
* [Remote development tips and tricks](https://code.visualstudio.com/docs/remote/troubleshooting)
10097
* [Using Docker with WSL 2 and VS Code](https://code.visualstudio.com/blogs/2020/03/02/docker-in-wsl2)
10198
* [Using C++ and WSL in VS Code](https://code.visualstudio.com/docs/cpp/config-wsl)
102-
* [Remote R Service for Linux](/visualstudio/rtvs/setting-up-remote-r-service-on-linux)
10399

104100
A few additional extensions you may want to consider include:
105101

106102
* [Keymaps from other editors](https://marketplace.visualstudio.com/search?target=VSCode&category=Keymaps&sortBy=Downloads): These extensions can help your environment feel right at home if you're transitioning from another text editor (like Atom, Sublime, Vim, eMacs, Notepad++, etc).
107-
* [Settings Sync](https://marketplace.visualstudio.com/items?itemName=Shan.code-settings-sync): Enables you to synchronize your VS Code settings across different installations using GitHub. If you work on different machines, this helps keep your environment consistent across them.
103+
* [Settings Sync](https://code.visualstudio.com/docs/configure/settings-sync): VS Code has built-in Settings Sync that lets you synchronize your settings, extensions, and keybindings across different machines using your GitHub or Microsoft account.

0 commit comments

Comments
 (0)