Skip to content

Commit e59221b

Browse files
authored
Merge pull request #96 from dotkernel/issue-92
Issue #92: Made distro setup page less tied to WSL 2
2 parents c3881b3 + 534c572 commit e59221b

File tree

9 files changed

+75
-71
lines changed

9 files changed

+75
-71
lines changed

docs/book/v1/running.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# Running AlmaLinux 9 on WSL 2
2+
3+
Open `Windows Terminal`.
4+
5+
Start **AlmaLinux 9** by executing:
6+
7+
```shell
8+
wsl -d AlmaLinux-9
9+
```
10+
11+
OR
12+
13+
Locate the app selector dropdown in `Windows Terminal`'s title bar and click `AlmaLinux-9`.
14+
This will open a new tab connected to **AlmaLinux 9**.
15+
16+
> To run your applications using WSL 2, you always need to be connected to your **AlmaLinux 9** distribution.
17+
> For this, all you need to do is to launch it from a terminal, file explorer or an IDE.
18+
> Once launched, you can close the tool you launched it from.
19+
> It will stay connected until you shut it down manually or reboot your computer.

docs/book/v1/setup/installation.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
1-
# AlmaLinux 9 Installation
1+
# Install AlmaLinux 9 on WSL 2
22

3-
Before proceeding with the installation, we need to make sure that no other WSL2 distribution (aka: _distro_) is running.
3+
Before proceeding with the installation, we need to make sure that no other WSL 2 distribution (aka: _distro_) is running.
44
This is important because this installation will fail if required ports are already in use by another distro.
55

66
Open `Windows Terminal`.
77

8-
## Stop other WSL2 distros
8+
## Stop other WSL 2 distros
99

1010
List all installed distros:
1111

docs/book/v1/setup/setup-packages.md

Lines changed: 8 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
# AlmaLinux 9 Setup
22

3-
> We recommend the use of [Hetzner Cloud via our referral link](https://hetzner.cloud/?ref=HYu6z4XGfkcP) for development thanks to the initial € 20 free [Hetzner Cloud credit](https://www.hetzner.com/legal/referrals).
3+
> The instructions below also work without using WSL.
44
5-
Install system packages:
5+
Update/Upgrade system packages:
66

77
```shell
8-
sudo dnf install epel-release dnf-utils https://rpms.remirepo.net/enterprise/remi-release-$(rpm -E %almalinux).rpm -y
8+
sudo dnf upgrade -y
99
```
1010

1111
You should see the below message, shown the first time you execute a command which requires elevated permissions (hence the `sudo` modifier at the beginning of the command).
@@ -23,10 +23,10 @@ Administrator. It usually boils down to these three things:
2323

2424
Input your **AlmaLinux 9** password and hit `Enter`.
2525

26-
Update/Upgrade system packages:
26+
Install system packages:
2727

2828
```shell
29-
sudo dnf upgrade -y
29+
sudo dnf install epel-release dnf-utils https://rpms.remirepo.net/enterprise/remi-release-$(rpm -E %almalinux).rpm -y
3030
```
3131

3232
Now, install the latest version of **Ansible**:
@@ -72,30 +72,12 @@ The installation process will ask for your **AlmaLinux 9** password, then iterat
7272

7373
Once finished, check if everything works by opening in your browser:
7474

75+
> If you are not using WSL 2, test the below using your server's IP address instead of `localhost`.
76+
7577
* [http://localhost/](http://localhost/): Apache's default home page
7678
* [http://localhost/info.php](http://localhost/info.php): PHP info page
7779
* [http://localhost/phpmyadmin/](http://localhost/phpmyadmin/): PhpMyAdmin (login with `root` + the root password you configured in `config.yml` under `mariadb` -> `root_password`)
7880

7981
The installation is complete, your **AlmaLinux 9** development environment is ready to use.
8082

81-
> Restart your `Windows Terminal` to find a new option in the tab selector, called **AlmaLinux-9** - clicking it will open a new tab connected to **AlmaLinux 9**.
82-
83-
## Running AlmaLinux 9
84-
85-
Open `Windows Terminal`.
86-
87-
Start **AlmaLinux 9** by executing:
88-
89-
```shell
90-
wsl -d AlmaLinux-9
91-
```
92-
93-
OR
94-
95-
Locate the app selector dropdown in `Windows Terminal`'s title bar and click `AlmaLinux-9`.
96-
This will open a new tab connected to **AlmaLinux 9**.
97-
98-
### Note
99-
100-
> To run your applications using WSL2, you always need to be connected to your **AlmaLinux 9** distribution.
101-
> For this, all you need to do is to keep open an instance of Windows Terminal that is connected to it.
83+
> If you are using WSL 2, restart your `Windows Terminal` to find a new option in the tab selector, called **AlmaLinux-9** - clicking it will open a new tab connected to **AlmaLinux 9**.

docs/book/v1/setup/system-requirements.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# AlmaLinux 9 System requirements
1+
# System requirements for AlmaLinux 9 on WSL 2
22

33
Open `Windows Terminal` and execute the following command:
44

@@ -18,13 +18,13 @@ DXCore version: 10.0.26091.1-240325-1447.ge-release
1818
Windows version: 10.0.22631.3737
1919
```
2020

21-
If the output starts with `WSL version: 2.x.x.x`, you are ready to use **WSL2** and can proceed to [install AlmaLinux 9](installation.md).
21+
If the output starts with `WSL version: 2.x.x.x`, you are ready to use WSL 2 and can proceed to [install AlmaLinux 9](installation.md).
2222

2323
## Install WSL2
2424

25-
Before proceeding with the installation, please consult Microsoft's [documentation](https://learn.microsoft.com/en-us/windows/wsl/install#prerequisites) regarding the minimum requirements for running WSL2.
25+
Before proceeding with the installation, please consult Microsoft's [documentation](https://learn.microsoft.com/en-us/windows/wsl/install#prerequisites) regarding the minimum requirements for running WSL 2.
2626

27-
Once you identified that your machine can run WSL2, open the `Run` prompt by pressing `Win` + `r`, type `OptionalFeatures` in the dialog and press `Enter`.
27+
Once you identified that your machine can run WSL 2, open the `Run` prompt by pressing `Win` + `r`, type `OptionalFeatures` in the dialog and press `Enter`.
2828
This will open a window where you can turn Windows features on/off.
2929
Make sure that the below features are activated (checked):
3030

@@ -38,7 +38,7 @@ Click `Ok` and restart your computer.
3838

3939
Open Microsoft Store, search for `Windows Subsystem for Linux` and install it.
4040

41-
Make sure that version **2** of WSL is set as default by executing the below command in Windows Terminal:
41+
Make sure that version `2` of WSL is set as default by executing the below command in Windows Terminal:
4242

4343
```shell
4444
wsl --set-default-version 2
@@ -50,4 +50,4 @@ To test, run again the following command:
5050
wsl -v
5151
```
5252

53-
This time the output should display `WSL version: 2.x.x.x`, which means that your system is ready for using **WSL2** and you can proceed to [install AlmaLinux 9](installation.md).
53+
This time the output should display `WSL version: 2.x.x.x`, which means that your system is ready for using WSL 2 and you can proceed to [install AlmaLinux 9](installation.md).

docs/book/v2/running.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# Running AlmaLinux 10 on WSL 2
2+
3+
Open `Windows Terminal`.
4+
5+
Start **AlmaLinux 10** by executing:
6+
7+
```shell
8+
wsl -d AlmaLinux-10
9+
```
10+
11+
OR
12+
13+
Locate the app selector dropdown in `Windows Terminal`'s title bar and click `AlmaLinux-10`.
14+
This will open a new tab connected to **AlmaLinux 10**.
15+
16+
> To run your applications using WSL 2, you always need to be connected to your **AlmaLinux 10** distribution.
17+
> For this, all you need to do is to launch it from a terminal, file explorer or an IDE.
18+
> Once launched, you can close the tool you launched it from.
19+
> It will stay connected until you shut it down manually or reboot your computer.

docs/book/v2/setup/installation.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
1-
# AlmaLinux 10 Installation
1+
# Install AlmaLinux 10 on WSL 2
22

3-
Before proceeding with the installation, we need to make sure that no other WSL2 distribution (aka: _distro_) is running.
3+
Before proceeding with the installation, we need to make sure that no other WSL 2 distribution (aka: _distro_) is running.
44
This is important because this installation will fail if required ports are already in use by another distro.
55

66
Open `Windows Terminal`.
77

8-
## Stop other WSL2 distros
8+
## Stop other WSL 2 distros
99

1010
List all installed distros:
1111

docs/book/v2/setup/setup-packages.md

Lines changed: 8 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
# AlmaLinux 10 Setup
22

3-
> We recommend the use of [Hetzner Cloud via our referral link](https://hetzner.cloud/?ref=HYu6z4XGfkcP) for development thanks to the initial € 20 free [Hetzner Cloud credit](https://www.hetzner.com/legal/referrals).
3+
> The instructions below also work without using WSL.
44
5-
Install system packages:
5+
Update/Upgrade system packages:
66

77
```shell
8-
sudo dnf install epel-release dnf-utils https://rpms.remirepo.net/enterprise/remi-release-$(rpm -E %almalinux).rpm -y
8+
sudo dnf upgrade -y
99
```
1010

1111
You should see the below message, shown the first time you execute a command which requires elevated permissions (hence the `sudo` modifier at the beginning of the command).
@@ -25,10 +25,10 @@ For security reasons, the password you type will not be visible.
2525

2626
Input your **AlmaLinux 10** password and hit `Enter`.
2727

28-
Update/Upgrade system packages:
28+
Install system packages:
2929

3030
```shell
31-
sudo dnf upgrade -y
31+
sudo dnf install epel-release dnf-utils https://rpms.remirepo.net/enterprise/remi-release-$(rpm -E %almalinux).rpm -y
3232
```
3333

3434
Now, install the latest version of **Ansible Core** and run **ansible-galaxy** to install collections:
@@ -78,30 +78,12 @@ The installation process will ask for your **AlmaLinux 10** password, then itera
7878

7979
Once finished, check if everything works by opening in your browser:
8080

81+
> If you are not using WSL 2, test the below using your server's IP address instead of `localhost`.
82+
8183
* [http://localhost/](http://localhost/): Apache's default home page
8284
* [http://localhost/info.php](http://localhost/info.php): PHP info page
8385
* [http://localhost/phpmyadmin/](http://localhost/phpmyadmin/): PhpMyAdmin (login with `root` + the root password you configured in `config.yml` under `mariadb` -> `root_password`)
8486

8587
The installation is complete, your **AlmaLinux 10** development environment is ready to use.
8688

87-
> Restart your `Windows Terminal` to find a new option in the tab selector, called **AlmaLinux-10**; clicking it will open a new tab connected to **AlmaLinux 10**.
88-
89-
## Running AlmaLinux 10
90-
91-
Open `Windows Terminal`.
92-
93-
Start **AlmaLinux 10** by executing:
94-
95-
```shell
96-
wsl -d AlmaLinux-10
97-
```
98-
99-
OR
100-
101-
Locate the app selector dropdown in `Windows Terminal`'s title bar and click `AlmaLinux-10`.
102-
This will open a new tab connected to **AlmaLinux 10**.
103-
104-
### Note
105-
106-
> To run your applications using WSL2, you always need to be connected to your **AlmaLinux 10** distribution.
107-
> For this, all you need to do is to keep open an instance of Windows Terminal that is connected to it.
89+
> If you are using WSL 2, restart your `Windows Terminal` to find a new option in the tab selector, called **AlmaLinux-10**; clicking it will open a new tab connected to **AlmaLinux 10**.

docs/book/v2/setup/system-requirements.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# AlmaLinux 10 System requirements
1+
# System requirements for AlmaLinux 10 on WSL 2
22

33
Open `Windows Terminal` and execute the following command:
44

@@ -18,13 +18,13 @@ DXCore version: 10.0.26091.1-240325-1447.ge-release
1818
Windows version: 10.0.22631.3737
1919
```
2020

21-
If the output starts with `WSL version: 2.x.x.x`, you are ready to use **WSL2** and can proceed to [install AlmaLinux 10](installation.md).
21+
If the output starts with `WSL version: 2.x.x.x`, you are ready to use WSL 2 and can proceed to [install AlmaLinux 10](installation.md).
2222

23-
## Install WSL2
23+
## Install WSL 2
2424

25-
Before proceeding with the installation, please consult Microsoft's [documentation](https://learn.microsoft.com/en-us/windows/wsl/install#prerequisites) regarding the minimum requirements for running WSL2.
25+
Before proceeding with the installation, please consult Microsoft's [documentation](https://learn.microsoft.com/en-us/windows/wsl/install#prerequisites) regarding the minimum requirements for running WSL 2.
2626

27-
Once you identified that your machine can run WSL2, open the `Run` prompt by pressing `Win` + `r`, type `OptionalFeatures` in the dialog and press `Enter`.
27+
Once you identified that your machine can run WSL 2, open the `Run` prompt by pressing `Win` + `r`, type `OptionalFeatures` in the dialog and press `Enter`.
2828
This will open a window where you can turn Windows features on/off.
2929
Make sure that the below features are activated (checked):
3030

@@ -38,7 +38,7 @@ Click `Ok` and restart your computer.
3838

3939
Open Microsoft Store, search for `Windows Subsystem for Linux` and install it.
4040

41-
Make sure that version **2** of WSL is set as default by executing the below command in Windows Terminal:
41+
Make sure that version `2` of WSL is set as default by executing the below command in Windows Terminal:
4242

4343
```shell
4444
wsl --set-default-version 2
@@ -50,4 +50,4 @@ To test, run again the following command:
5050
wsl -v
5151
```
5252

53-
This time the output should display `WSL version: 2.x.x.x`, which means that your system is ready for using **WSL2** and you can proceed to [install AlmaLinux 10](installation.md).
53+
This time the output should display `WSL version: 2.x.x.x`, which means that your system is ready for using WSL 2 and you can proceed to [install AlmaLinux 10](installation.md).

mkdocs.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ nav:
1414
- System Requirements: v2/setup/system-requirements.md
1515
- Installation: v2/setup/installation.md
1616
- Setup Packages: v2/setup/setup-packages.md
17+
- Running on WSL 2: v2/running.md
1718
- Virtualhosts:
1819
- Overview: v2/virtualhosts/overview.md
1920
- Create virtualhost: v2/virtualhosts/create-virtualhost.md
@@ -24,6 +25,7 @@ nav:
2425
- System Requirements: v1/setup/system-requirements.md
2526
- Installation: v1/setup/installation.md
2627
- Setup Packages: v1/setup/setup-packages.md
28+
- Running on WSL 2: v1/running.md
2729
- Virtualhosts:
2830
- Overview: v1/virtualhosts/overview.md
2931
- Create virtualhost: v1/virtualhosts/create-virtualhost.md

0 commit comments

Comments
 (0)