Skip to content

Commit bf1507c

Browse files
committed
Added WSL2 clean start instructions to docs and README
Signed-off-by: alexmerlin <alex.merlin.1985@gmail.com>
1 parent b0b0874 commit bf1507c

File tree

3 files changed

+110
-3
lines changed

3 files changed

+110
-3
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

docs/book/v2/setup/installation.md

Lines changed: 34 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,41 @@
11
# Install AlmaLinux10
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-almalinux10-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-8 Stopped 2
29+
* AlmaLinux-9 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-9`.
34+
Once you have stopped all distros, you can continue to the [installation](#install-almalinux10-1) section.
35+
36+
## Install AlmaLinux10
37+
38+
List the available Linux distros by executing:
639

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

wsl/README.md

Lines changed: 42 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,41 @@
11
# Install AlmaLinux10
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-almalinux10-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-8 Stopped 2
29+
* AlmaLinux-9 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-9`.
34+
Once you have stopped all distros, you can continue to the [installation](#install-almalinux10-1) section.
35+
36+
## Install AlmaLinux10
37+
38+
List the available Linux distros by executing:
639

740
```shell
841
wsl --list --online
@@ -39,6 +72,14 @@ OracleLinux_9_1 Oracle Linux 9.1
3972

4073
Note the two columns: **NAME** and **FRIENDLY NAME**.
4174
To install a specific distro, use the value from the **NAME** column, in this case: `AlmaLinux-10`.
75+
76+
> If you try to install a distro that is already installed, the installation process will fail:
77+
>
78+
> Downloading: AlmaLinux OS 10
79+
> Installing: AlmaLinux OS 10
80+
> A distribution with the supplied name already exists. Use --name to choose a different name.
81+
> Error code: Wsl/InstallDistro/Service/RegisterDistro/ERROR_ALREADY_EXISTS
82+
4283
Install the AlmaLinux10 distro by executing the below command:
4384

4485
```shell

0 commit comments

Comments
 (0)