Skip to content

Commit d674947

Browse files
Merge pull request #2517 from GrantMeStrength/jken/stale-content-updates
Update stale WSL + VS Code and Windows Server install pages
2 parents 33db75e + 462cef7 commit d674947

2 files changed

Lines changed: 18 additions & 14 deletions

File tree

WSL/install-on-server.md

Lines changed: 13 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,15 @@ 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+
> To use WSL 2, install or update the WSL kernel using the method for your Windows Server version:
51+
> - On Windows Server 2022 and later, run:
52+
> ```powershell
53+
> wsl --update
54+
> ```
55+
> - On Windows Server 2019, install the WSL 2 kernel update using the MSI package shown below.
56+
57+
For Windows Server 2019, you can install the WSL 2 kernel update using the MSI package:
5058
5159
```powershell
5260
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)