Skip to content

Commit ea9e4b2

Browse files
committed
docs: update distributions.md
1 parent 1a8a9f1 commit ea9e4b2

File tree

1 file changed

+25
-13
lines changed

1 file changed

+25
-13
lines changed

wsl/reference/distributions.md

Lines changed: 25 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,38 @@
11
# Distributions
22

3-
Our flagship distribution (distro) is Ubuntu. It is the default option when you install WSL for the first time. However, we develop several flavours for the Ubuntu distro and one or more of these flavours may fit your needs better.
3+
Our flagship distribution (distro) is Ubuntu. It is the default option when you install WSL for the first time. Several releases of the Ubuntu distro are available for WSL.
44

5-
Each of these flavours corresponds to a different application on the Microsoft Store, and once installed, they'll create different flavors in your WSL.
65

7-
## Ubuntu Variants
8-
These are the variants of the default Ubuntu flavor we develop and maintain:
6+
Each release of Ubuntu for WSL is available as an application from the Microsoft Store. Once a release is [installed](https://documentation.ubuntu.com/wsl/en/latest/howto/install-ubuntu-wsl2/#method-1-microsoft-store-application), it will be available to use in your WSL environment.
97

10-
- [Ubuntu](https://apps.microsoft.com/detail/9PDXGNCFSCZV?hl=en-us&gl=US) ships the latest stable LTS release of Ubuntu. When new LTS versions are released, Ubuntu can be upgraded once the first point release is available.
11-
- Numbered releases, for example [Ubuntu 22.04.3 LTS](https://apps.microsoft.com/detail/9PN20MSR04DW?hl=en-us&gl=US) refer to specific Long Term Stability (LTS) releases that are supported for five years. For more information on releases, support and timelines, visit the [Ubuntu releases page](https://wiki.ubuntu.com/Releases).
12-
- [Ubuntu (Preview)](https://apps.microsoft.com/detail/9P7BDVKVNXZ6?hl=en-us&gl=US) is a daily build of the latest development version of Ubuntu previewing new features as they are developed. It does not receive the same level of QA as stable releases and should not be used for production workloads.
8+
## Releases of Ubuntu on WSL
9+
These are the releases of Ubuntu that we support and that are available on the Microsoft Store:
10+
11+
- [Ubuntu](https://apps.microsoft.com/detail/9PDXGNCFSCZV?hl=en-us&gl=US) ships the latest stable LTS (Long Term Support) release of Ubuntu. When new LTS versions are released, this release of Ubuntu can be upgraded once the first point release is available.
12+
- Numbered releases, for example [Ubuntu 22.04 LTS](https://apps.microsoft.com/detail/9PN20MSR04DW?hl=en-us&gl=US), refer to specific Long Term Stability (LTS) releases that receive standard support for five years. For more information on LTS releases, support and timelines, visit the [Ubuntu releases page](https://wiki.ubuntu.com/Releases). Numbered releases of Ubuntu on WSL will not be upgraded unless configured to upgrade in `etc/update-manager/release-upgrades`.
13+
- [Ubuntu (Preview)](https://apps.microsoft.com/detail/9P7BDVKVNXZ6?hl=en-us&gl=US) is a daily build of the latest development version of Ubuntu, which previews new features as they are developed. It does not receive the same level of QA as stable releases and should not be used for production workloads.
14+
15+
:::{note}
16+
Interim releases of Ubuntu are currently not supported on WSL.
17+
:::
1318

1419
## Naming
15-
The variants of the default Ubuntu flavor is available under different names depending the context you try to access it with. Here is a table matching them.
20+
Depending on context, releases of Ubuntu are referred to by different names:
1621

17-
1. App name is the name you'll see in the Microsoft Store and Winget.
18-
2. AppxPackage is the name you'll see in `Get-AppxPackage`.
19-
3. Distro name is the name you'll see when doing `wsl -l -v` or `wsl -l --online`.
20-
4. Executable is the program you need to run to start the distro.
22+
1. **App name** is the name of the application for a specific Ubuntu release that you will see in the Microsoft Store.
23+
2. **AppxPackage** is the name that can be passed to `Get-AppxPackage -Name` in PowerShell to get information about an installed package.
24+
3. **Distro name** is the name logged when you invoke `wsl -l -v` to list installed releases of Ubuntu.
25+
4. **Executable** is the program you need to run to start the Ubuntu distro.
2126

22-
| App name | AppxPackage name | Variant | Executable |
27+
These naming conventions are summarised in the table below:
28+
29+
| App name | AppxPackage name | Distro name | Executable |
2330
| -------------------- | -------------------------------------- | ---------------- | ------------------- |
2431
| `Ubuntu` | `CanonicalGroupLimited.Ubuntu` | `Ubuntu` | `ubuntu.exe` |
2532
| `Ubuntu (Preview)` | `CanonicalGroupLimited.UbuntuPreview` | `Ubuntu-Preview` | `ubuntupreview.exe` |
2633
| `Ubuntu XX.YY.Z LTS` | `CanonicalGroupLimited.UbuntuXX.YYLTS` | `Ubuntu-XX.YY` | `ubuntuXXYY.exe` |
34+
35+
:::{note}
36+
The kernel used in WSL environments is maintained by Microsoft.
37+
Bug reports and support requests for the WSL kernel should be direct to the official repository for the WSL kernel.
38+
:::

0 commit comments

Comments
 (0)