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
{{ message }}
Repository navigation
Commit a1473a6
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: WSL/tutorials/wsl-containers.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
title: Get started with containers on WSL
3
3
description: Learn how to build and run Linux containers on the Windows Subsystem for Linux using the built-in wslc.exe CLI.
4
4
keywords: wsl, windows, windowssubsystem, windows 10, wslc, containers
5
-
ms.date: 06/19/2026
5
+
ms.date: 09/29/2026
6
6
ms.topic: get-started
7
7
---
8
8
@@ -18,22 +18,22 @@ A container is a tool used to create, deploy, and run applications. Containers e
18
18
19
19
## Prerequisites
20
20
21
-
- WSL installed, version 2.9.3 or higher. This version is currently only available as a pre-release, so run `wsl --update --pre-release` to get it.
21
+
- WSL installed, version 2.9.3 or higher. Run `wsl --update` to get the latest version.
22
22
-[Install Visual Studio Code](https://code.visualstudio.com/download)*(optional)*. This will provide the best experience, including the ability to code and debug your containerized projects connected to your Linux distribution.
23
23
-[Install Windows Terminal](/windows/terminal/get-started)*(optional)*. This will provide the best experience, including the ability to customize and open multiple terminals in the same interface (including Ubuntu, Debian, PowerShell, Azure CLI, or whatever you prefer to use).
24
24
25
25
## Install and verify wslc
26
26
27
27
`wslc.exe` is included with WSL, so there's no separate engine to install. It requires WSL version 2.9.3 or higher. To make sure you have a version of WSL that includes it:
28
28
29
-
1.[Install WSL](../install.md) if you haven't already, then update to the latest pre-release version by opening PowerShell and entering:
29
+
1.[Install WSL](../install.md) if you haven't already, then update to the latest version by opening PowerShell and entering:
30
30
31
31
```powershell
32
-
wsl --update --pre-release
32
+
wsl --update
33
33
```
34
34
35
35
> [!NOTE]
36
-
> WSL container is currently only available in pre-release builds (version 2.9.3 or higher), so the `--pre-release` flag is required. You can confirm your WSL version with `wsl --version`.
36
+
> WSL container requires WSL version 2.9.3 or higher. You can confirm your WSL version with `wsl --version`.
37
37
38
38
2. Confirm that `wslc.exe` is available and check its version by entering:
The WSL container feature has two major components: a CLI called `wslc.exe` to build, run and interact with Linux containers and a WSL container API allowing Windows app developers to use Linux containers as part of their app logic.
13
13
14
14
> [!IMPORTANT]
15
-
> The WSL container feature requires **WSL version 2.9.3 or higher**. This version is currently only available as a pre-release, so you need to install it by opening PowerShell and entering:
15
+
> The WSL container feature requires **WSL version 2.9.3 or higher**. To update to the latest version, open PowerShell and enter:
16
16
>
17
17
> ```powershell
18
-
> wsl --update --pre-release
18
+
> wsl --update
19
19
> ```
20
20
>
21
21
> Check your installed version at any time with `wsl --version`.
0 commit comments