Skip to content

Commit adc55a5

Browse files
committed
Added WSL2 clean start instructions to docs and README
Signed-off-by: alexmerlin <[email protected]>
1 parent cf86a8d commit adc55a5

File tree

2 files changed

+68
-2
lines changed

2 files changed

+68
-2
lines changed

docs/book/v1/setup/installation.md

Lines changed: 34 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,41 @@
11
# Install AlmaLinux9
22

3+
Before proceeding with the installation, we need to make sure that no other WSL2 distribution (aka: _distro_) is running.
4+
This is important because this installation will fail if required ports are already in use by another distro.
5+
36
Open `Windows Terminal`.
47

5-
List the available Linux distributions (aka: _distros_) by executing:
8+
## Stop other WSL2 distros
9+
10+
List all installed distros:
11+
12+
```shell
13+
wsl -l -v
14+
```
15+
16+
If there is no other distro installed, you will see the below output (an empty list):
17+
18+
```text
19+
NAME STATE VERSION
20+
```
21+
22+
In this case, you can jump to the [installation](#install-almalinux9-1) section.
23+
24+
If you have other distros installed, the output could look similar to the below:
25+
26+
```text
27+
NAME STATE VERSION
28+
* AlmaLinux-9 Stopped 2
29+
* AlmaLinux-10 Running 2
30+
```
31+
32+
Make sure that the **STATE** column reads **Stopped** for all distros.
33+
If any of them reads **Running**, you must stop if first by executing `wsl -t <distro-name>`, for example: `wsl -t AlmaLinux-10`.
34+
Once you have stopped all distros, you can continue to the [installation](#install-almalinux9-1) section.
35+
36+
## Install AlmaLinux9
37+
38+
List the available Linux distros by executing:
639

740
```shell
841
wsl --list --online

wsl/README.md

Lines changed: 34 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,41 @@
11
# Install AlmaLinux9
22

3+
Before proceeding with the installation, we need to make sure that no other WSL2 distribution (aka: _distro_) is running.
4+
This is important because this installation will fail if required ports are already in use by another distro.
5+
36
Open `Windows Terminal`.
47

5-
List the available Linux distributions (aka: _distros_) by executing:
8+
## Stop other WSL2 distros
9+
10+
List all installed distros:
11+
12+
```shell
13+
wsl -l -v
14+
```
15+
16+
If there is no other distro installed, you will see the below output (an empty list):
17+
18+
```text
19+
NAME STATE VERSION
20+
```
21+
22+
In this case, you can jump to the [installation](#install-almalinux9-1) section.
23+
24+
If you have other distros installed, the output could look similar to the below:
25+
26+
```text
27+
NAME STATE VERSION
28+
* AlmaLinux-9 Stopped 2
29+
* AlmaLinux-10 Running 2
30+
```
31+
32+
Make sure that the **STATE** column reads **Stopped** for all distros.
33+
If any of them reads **Running**, you must stop if first by executing `wsl -t <distro-name>`, for example: `wsl -t AlmaLinux-10`.
34+
Once you have stopped all distros, you can continue to the [installation](#install-almalinux9-1) section.
35+
36+
## Install AlmaLinux9
37+
38+
List the available Linux distros by executing:
639

740
```shell
841
wsl --list --online

0 commit comments

Comments
 (0)