From 5b64b25b200be932d1fef784fcf07161066498ae Mon Sep 17 00:00:00 2001 From: alexmerlin Date: Wed, 1 Oct 2025 09:26:47 +0300 Subject: [PATCH 1/3] Issue #92: Made distro setup page less tied to WSL 2 Signed-off-by: alexmerlin --- docs/book/v1/running.md | 21 ++++++++++++++ docs/book/v1/setup/installation.md | 6 ++-- docs/book/v1/setup/setup-packages.md | 34 ++++++----------------- docs/book/v1/setup/system-requirements.md | 12 ++++---- docs/book/v2/running.md | 21 ++++++++++++++ docs/book/v2/setup/installation.md | 6 ++-- docs/book/v2/setup/setup-packages.md | 34 ++++++----------------- docs/book/v2/setup/system-requirements.md | 14 +++++----- mkdocs.yml | 2 ++ 9 files changed, 79 insertions(+), 71 deletions(-) create mode 100644 docs/book/v1/running.md create mode 100644 docs/book/v2/running.md diff --git a/docs/book/v1/running.md b/docs/book/v1/running.md new file mode 100644 index 0000000..a9b4949 --- /dev/null +++ b/docs/book/v1/running.md @@ -0,0 +1,21 @@ +## Running AlmaLinux 9 on WSL 2 + +Open `Windows Terminal`. + +Start **AlmaLinux 9** by executing: + +```shell +wsl -d AlmaLinux-9 +``` + +OR + +Locate the app selector dropdown in `Windows Terminal`'s title bar and click `AlmaLinux-9`. +This will open a new tab connected to **AlmaLinux 9**. + +### Note + +> To run your applications using WSL 2, you always need to be connected to your **AlmaLinux 9** distribution. +> For this, all you need to do is to launch it from a terminal, file explorer or an IDE. +> Once launched, you can close the tool you launched it from. +> It will stay connected until you shut it down manually or reboot your computer. diff --git a/docs/book/v1/setup/installation.md b/docs/book/v1/setup/installation.md index 849e793..1c36ddd 100644 --- a/docs/book/v1/setup/installation.md +++ b/docs/book/v1/setup/installation.md @@ -1,11 +1,11 @@ -# AlmaLinux 9 Installation +# Install AlmaLinux 9 on WSL 2 -Before proceeding with the installation, we need to make sure that no other WSL2 distribution (aka: _distro_) is running. +Before proceeding with the installation, we need to make sure that no other WSL 2 distribution (aka: _distro_) is running. This is important because this installation will fail if required ports are already in use by another distro. Open `Windows Terminal`. -## Stop other WSL2 distros +## Stop other WSL 2 distros List all installed distros: diff --git a/docs/book/v1/setup/setup-packages.md b/docs/book/v1/setup/setup-packages.md index 77c9c07..81c1316 100644 --- a/docs/book/v1/setup/setup-packages.md +++ b/docs/book/v1/setup/setup-packages.md @@ -1,11 +1,11 @@ # AlmaLinux 9 Setup -> 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). +> The below instructions are working for virtual servers too. -Install system packages: +Update/Upgrade system packages: ```shell -sudo dnf install epel-release dnf-utils https://rpms.remirepo.net/enterprise/remi-release-$(rpm -E %almalinux).rpm -y +sudo dnf upgrade -y ``` 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: Input your **AlmaLinux 9** password and hit `Enter`. -Update/Upgrade system packages: +Install system packages: ```shell -sudo dnf upgrade -y +sudo dnf install epel-release dnf-utils https://rpms.remirepo.net/enterprise/remi-release-$(rpm -E %almalinux).rpm -y ``` Now, install the latest version of **Ansible**: @@ -72,30 +72,12 @@ The installation process will ask for your **AlmaLinux 9** password, then iterat Once finished, check if everything works by opening in your browser: +> If you are not using WSL 2, test the below using your server's IP address instead of `localhost`. + * [http://localhost/](http://localhost/): Apache's default home page * [http://localhost/info.php](http://localhost/info.php): PHP info page * [http://localhost/phpmyadmin/](http://localhost/phpmyadmin/): PhpMyAdmin (login with `root` + the root password you configured in `config.yml` under `mariadb` -> `root_password`) The installation is complete, your **AlmaLinux 9** development environment is ready to use. -> 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**. - -## Running AlmaLinux 9 - -Open `Windows Terminal`. - -Start **AlmaLinux 9** by executing: - -```shell -wsl -d AlmaLinux-9 -``` - -OR - -Locate the app selector dropdown in `Windows Terminal`'s title bar and click `AlmaLinux-9`. -This will open a new tab connected to **AlmaLinux 9**. - -### Note - -> To run your applications using WSL2, you always need to be connected to your **AlmaLinux 9** distribution. -> For this, all you need to do is to keep open an instance of Windows Terminal that is connected to it. +> 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**. diff --git a/docs/book/v1/setup/system-requirements.md b/docs/book/v1/setup/system-requirements.md index fff8c7d..e2a24fe 100644 --- a/docs/book/v1/setup/system-requirements.md +++ b/docs/book/v1/setup/system-requirements.md @@ -1,4 +1,4 @@ -# AlmaLinux 9 System requirements +# System requirements for AlmaLinux 9 on WSL 2 Open `Windows Terminal` and execute the following command: @@ -18,13 +18,13 @@ DXCore version: 10.0.26091.1-240325-1447.ge-release Windows version: 10.0.22631.3737 ``` -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). +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). ## Install WSL2 -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. +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. -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`. +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`. This will open a window where you can turn Windows features on/off. Make sure that the below features are activated (checked): @@ -38,7 +38,7 @@ Click `Ok` and restart your computer. Open Microsoft Store, search for `Windows Subsystem for Linux` and install it. -Make sure that version **2** of WSL is set as default by executing the below command in Windows Terminal: +Make sure that version `2` of WSL is set as default by executing the below command in Windows Terminal: ```shell wsl --set-default-version 2 @@ -50,4 +50,4 @@ To test, run again the following command: wsl -v ``` -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). +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). diff --git a/docs/book/v2/running.md b/docs/book/v2/running.md new file mode 100644 index 0000000..631291d --- /dev/null +++ b/docs/book/v2/running.md @@ -0,0 +1,21 @@ +## Running AlmaLinux 10 on WSL 2 + +Open `Windows Terminal`. + +Start **AlmaLinux 10** by executing: + +```shell +wsl -d AlmaLinux-10 +``` + +OR + +Locate the app selector dropdown in `Windows Terminal`'s title bar and click `AlmaLinux-10`. +This will open a new tab connected to **AlmaLinux 10**. + +### Note + +> To run your applications using WSL 2, you always need to be connected to your **AlmaLinux 10** distribution. +> For this, all you need to do is to launch it from a terminal, file explorer or an IDE. +> Once launched, you can close the tool you launched it from. +> It will stay connected until you shut it down manually or reboot your computer. diff --git a/docs/book/v2/setup/installation.md b/docs/book/v2/setup/installation.md index e667550..ef21c37 100644 --- a/docs/book/v2/setup/installation.md +++ b/docs/book/v2/setup/installation.md @@ -1,11 +1,11 @@ -# AlmaLinux 10 Installation +# Install AlmaLinux 10 on WSL 2 -Before proceeding with the installation, we need to make sure that no other WSL2 distribution (aka: _distro_) is running. +Before proceeding with the installation, we need to make sure that no other WSL 2 distribution (aka: _distro_) is running. This is important because this installation will fail if required ports are already in use by another distro. Open `Windows Terminal`. -## Stop other WSL2 distros +## Stop other WSL 2 distros List all installed distros: diff --git a/docs/book/v2/setup/setup-packages.md b/docs/book/v2/setup/setup-packages.md index f7f23c5..7c788c6 100644 --- a/docs/book/v2/setup/setup-packages.md +++ b/docs/book/v2/setup/setup-packages.md @@ -1,11 +1,11 @@ # AlmaLinux 10 Setup -> 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). +> The below instructions are working for virtual servers too. -Install system packages: +Update/Upgrade system packages: ```shell -sudo dnf install epel-release dnf-utils https://rpms.remirepo.net/enterprise/remi-release-$(rpm -E %almalinux).rpm -y +sudo dnf upgrade -y ``` 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. Input your **AlmaLinux 10** password and hit `Enter`. -Update/Upgrade system packages: +Install system packages: ```shell -sudo dnf upgrade -y +sudo dnf install epel-release dnf-utils https://rpms.remirepo.net/enterprise/remi-release-$(rpm -E %almalinux).rpm -y ``` 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 Once finished, check if everything works by opening in your browser: +> If you are not using WSL 2, test the below using your server's IP address instead of `localhost`. + * [http://localhost/](http://localhost/): Apache's default home page * [http://localhost/info.php](http://localhost/info.php): PHP info page * [http://localhost/phpmyadmin/](http://localhost/phpmyadmin/): PhpMyAdmin (login with `root` + the root password you configured in `config.yml` under `mariadb` -> `root_password`) The installation is complete, your **AlmaLinux 10** development environment is ready to use. -> 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**. - -## Running AlmaLinux 10 - -Open `Windows Terminal`. - -Start **AlmaLinux 10** by executing: - -```shell -wsl -d AlmaLinux-10 -``` - -OR - -Locate the app selector dropdown in `Windows Terminal`'s title bar and click `AlmaLinux-10`. -This will open a new tab connected to **AlmaLinux 10**. - -### Note - -> To run your applications using WSL2, you always need to be connected to your **AlmaLinux 10** distribution. -> For this, all you need to do is to keep open an instance of Windows Terminal that is connected to it. +> 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**. diff --git a/docs/book/v2/setup/system-requirements.md b/docs/book/v2/setup/system-requirements.md index c8a450e..865f129 100644 --- a/docs/book/v2/setup/system-requirements.md +++ b/docs/book/v2/setup/system-requirements.md @@ -1,4 +1,4 @@ -# AlmaLinux 10 System requirements +# System requirements for AlmaLinux 10 on WSL 2 Open `Windows Terminal` and execute the following command: @@ -18,13 +18,13 @@ DXCore version: 10.0.26091.1-240325-1447.ge-release Windows version: 10.0.22631.3737 ``` -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). +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). -## Install WSL2 +## Install WSL 2 -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. +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. -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`. +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`. This will open a window where you can turn Windows features on/off. Make sure that the below features are activated (checked): @@ -38,7 +38,7 @@ Click `Ok` and restart your computer. Open Microsoft Store, search for `Windows Subsystem for Linux` and install it. -Make sure that version **2** of WSL is set as default by executing the below command in Windows Terminal: +Make sure that version `2` of WSL is set as default by executing the below command in Windows Terminal: ```shell wsl --set-default-version 2 @@ -50,4 +50,4 @@ To test, run again the following command: wsl -v ``` -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). +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). diff --git a/mkdocs.yml b/mkdocs.yml index ee1d16f..7a82379 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -14,6 +14,7 @@ nav: - System Requirements: v2/setup/system-requirements.md - Installation: v2/setup/installation.md - Setup Packages: v2/setup/setup-packages.md + - Running on WSL 2: v2/running.md - Virtualhosts: - Overview: v2/virtualhosts/overview.md - Create virtualhost: v2/virtualhosts/create-virtualhost.md @@ -24,6 +25,7 @@ nav: - System Requirements: v1/setup/system-requirements.md - Installation: v1/setup/installation.md - Setup Packages: v1/setup/setup-packages.md + - Running on WSL 2: v1/running.md - Virtualhosts: - Overview: v1/virtualhosts/overview.md - Create virtualhost: v1/virtualhosts/create-virtualhost.md From b75846a6b2008003cbb80fe4e6d32376bbc0f2e7 Mon Sep 17 00:00:00 2001 From: alexmerlin Date: Wed, 1 Oct 2025 09:28:33 +0300 Subject: [PATCH 2/3] Issue #92: Made distro setup page less tied to WSL 2 Signed-off-by: alexmerlin --- docs/book/v1/running.md | 4 +--- docs/book/v2/running.md | 4 +--- 2 files changed, 2 insertions(+), 6 deletions(-) diff --git a/docs/book/v1/running.md b/docs/book/v1/running.md index a9b4949..3ce46d2 100644 --- a/docs/book/v1/running.md +++ b/docs/book/v1/running.md @@ -1,4 +1,4 @@ -## Running AlmaLinux 9 on WSL 2 +# Running AlmaLinux 9 on WSL 2 Open `Windows Terminal`. @@ -13,8 +13,6 @@ OR Locate the app selector dropdown in `Windows Terminal`'s title bar and click `AlmaLinux-9`. This will open a new tab connected to **AlmaLinux 9**. -### Note - > To run your applications using WSL 2, you always need to be connected to your **AlmaLinux 9** distribution. > For this, all you need to do is to launch it from a terminal, file explorer or an IDE. > Once launched, you can close the tool you launched it from. diff --git a/docs/book/v2/running.md b/docs/book/v2/running.md index 631291d..22c31d9 100644 --- a/docs/book/v2/running.md +++ b/docs/book/v2/running.md @@ -1,4 +1,4 @@ -## Running AlmaLinux 10 on WSL 2 +# Running AlmaLinux 10 on WSL 2 Open `Windows Terminal`. @@ -13,8 +13,6 @@ OR Locate the app selector dropdown in `Windows Terminal`'s title bar and click `AlmaLinux-10`. This will open a new tab connected to **AlmaLinux 10**. -### Note - > To run your applications using WSL 2, you always need to be connected to your **AlmaLinux 10** distribution. > For this, all you need to do is to launch it from a terminal, file explorer or an IDE. > Once launched, you can close the tool you launched it from. From 534c57290d24246bc2875e07aeb2006a0865cdf6 Mon Sep 17 00:00:00 2001 From: alexmerlin Date: Wed, 1 Oct 2025 12:51:27 +0300 Subject: [PATCH 3/3] Issue #92: Made distro setup page less tied to WSL 2 Signed-off-by: alexmerlin --- docs/book/v1/setup/setup-packages.md | 2 +- docs/book/v2/setup/setup-packages.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/book/v1/setup/setup-packages.md b/docs/book/v1/setup/setup-packages.md index 81c1316..eaf715e 100644 --- a/docs/book/v1/setup/setup-packages.md +++ b/docs/book/v1/setup/setup-packages.md @@ -1,6 +1,6 @@ # AlmaLinux 9 Setup -> The below instructions are working for virtual servers too. +> The instructions below also work without using WSL. Update/Upgrade system packages: diff --git a/docs/book/v2/setup/setup-packages.md b/docs/book/v2/setup/setup-packages.md index 7c788c6..8542806 100644 --- a/docs/book/v2/setup/setup-packages.md +++ b/docs/book/v2/setup/setup-packages.md @@ -1,6 +1,6 @@ # AlmaLinux 10 Setup -> The below instructions are working for virtual servers too. +> The instructions below also work without using WSL. Update/Upgrade system packages: