Skip to content

docs(wsl.md, almalinux-os-kitten-10.md): how to install AlmaLinux 10, Kitten x86_64_v2 WSL #762

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
yuravk wants to merge 2 commits into
base: master
Choose a base branch
from
Open

docs(wsl.md, almalinux-os-kitten-10.md): how to install AlmaLinux 10, Kitten x86_64_v2 WSL #762

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e081e17
docs(wsl.md, almalinux-os-kitten-10.md): how to install AlmaLinux 10,…
yuravk Mar 26, 2026
664e3cb
Apply Prettier format
autofix-ci[bot] Mar 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 19 additions & 1 deletion docs/development/almalinux-os-kitten-10.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -145,12 +145,30 @@ AlmaLinux OS Kitten 10 images are available for installation via WSL CLI tool.
wsl --install AlmaLinux-Kitten-10
```
- Launch AlmaLinux OS to start using it:
- Open it from the Windows Terminal. Click the small arrow ▾ next to the tab or the “+” icon. You’ll see a dropdown with available WSL distros listed. Click AlmaLinux-Kitten-10. It will open in a new tab, ready to use.
- Open it from the Windows Terminal. Click the small arrow ▾ next to the tab or the "+" icon. You'll see a dropdown with available WSL distros listed. Click AlmaLinux-Kitten-10. It will open in a new tab, ready to use.
- Or run the command:
```
wsl -d AlmaLinux-Kitten-10
```

### x86_64_v2 WSL Images

AlmaLinux OS Kitten 10 x86_64_v2 images are not published to the Microsoft Store or [microsoft/WSL](https://github.com/microsoft/WSL) and can only be downloaded from the [Releases](https://github.com/AlmaLinux/wsl-images/releases) section of the AlmaLinux WSL images GitHub repository. They are available for offline installation via `wsl --install --from-file`.

- Download the latest `.wsl` file for Kitten 10 x86*64_v2 from [github.com/AlmaLinux/wsl-images/releases](https://github.com/AlmaLinux/wsl-images/releases) (e.g. `AlmaLinux-Kitten-10_x64_v2*<version>.wsl`).

- Install it using the `--from-file` option:

```
wsl --install --from-file AlmaLinux-Kitten-10_x64_v2_<version>.wsl
```

- Launch AlmaLinux OS Kitten:
- Open it from the Windows Terminal dropdown, or run the command:
```
wsl -d AlmaLinux-Kitten-10-x64_v2
```

More about AlmaLinux for WSL - [WSL Page](/documentation/WSL).

## How is AlmaLinux OS Kitten different from CentOS Stream?
Expand Down
22 changes: 21 additions & 1 deletion docs/documentation/wsl.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,8 @@ The following AlmaLinux OS versions are available for installation via both meth
- AlmaLinux OS 9
- AlmaLinux OS 10

Additionally, **AlmaLinux OS 10 x86_64_v2** images are available. These images are not published to the Microsoft Store or [microsoft/WSL](https://github.com/microsoft/WSL) and can only be downloaded from the [Releases](https://github.com/AlmaLinux/wsl-images/releases) section of the AlmaLinux WSL images GitHub repository. They are available for offline installation via `wsl --install --from-file` (see [Install AlmaLinux OS 10 x86_64_v2](#install-almalinux-os-10-x86_64_v2) below).

:::tip
If you are looking for AlmaLinux OS Kitten image, please, visit the [AlmaLinux OS Kitten page](/development/almalinux-os-kitten-10).
:::
Expand Down Expand Up @@ -142,12 +144,30 @@ The WSL format is a modern and recommended way of installation. The WSL version
```

- Start your AlmaLinux:
- Open it from the Windows Terminal. Click the small arrow ▾ next to the tab or the “+” icon. You’ll see a dropdown with available WSL distros listed. Click AlmaLinux OS. It will open in a new tab, ready to use.
- Open it from the Windows Terminal. Click the small arrow ▾ next to the tab or the "+" icon. You'll see a dropdown with available WSL distros listed. Click AlmaLinux OS. It will open in a new tab, ready to use.
- Or run the command:
```
wsl -d AlmaLinux-10
```

### Install AlmaLinux OS 10 x86_64_v2

AlmaLinux OS 10 x86_64_v2 images are not published to the Microsoft Store or [microsoft/WSL](https://github.com/microsoft/WSL). They can only be downloaded from the [Releases](https://github.com/AlmaLinux/wsl-images/releases) section of the AlmaLinux WSL images GitHub repository and installed offline using the `wsl` tool.

- Download the latest `.wsl` file for x86*64_v2 from [github.com/AlmaLinux/wsl-images/releases](https://github.com/AlmaLinux/wsl-images/releases) (e.g. `AlmaLinux-10.1_x64_v2*<version>.wsl`).

- Install it using the `--from-file` option:

```
wsl --install --from-file AlmaLinux-10.1_x64_v2_<version>.wsl
```

- Start your AlmaLinux:
- Open it from the Windows Terminal dropdown, or run the command:
```
wsl -d AlmaLinux-10-x64_v2
```

## Extras

### Official Microsoft documentation
Expand Down
Loading