You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This is a collection of Ansible scripts allowing the creation and maintenance of your WSL2 development environment.
3
+
This is a collection of Ansible scripts helping with the creation and maintenance of your WSL2 development environment.
4
4
5
-
## Prerequisites
5
+
If you're not already using it, we recommend you to install [Windows Terminal](https://apps.microsoft.com/detail/9n0dx20hk701?hl=en-US&gl=US).
6
+
It is a modern tool that incorporates the power of multiple already known command-line applications like `Windows PowerShell`, `Linux shell`, and more...
6
7
7
-
If you're not already using it, we recommend you to install [Windows Terminal](https://www.microsoft.com/en-US/p/windows-terminal/9n0dx20hk701?activetab=pivot:overviewtab).
8
+
## Check if WLS2 is already available
8
9
9
-
It's a modern tool that incorporates the power of multiple already known command-line applications like `Windows PowerShell`, `Linux shell`, and more...
10
+
Open `Windows Terminal` and execute the following command:
If the output starts with `WSL version: 2.x.x.x`, you are ready to use **WSL2** and can proceed to [install AlmaLinux9](wsl/README.md).
29
+
30
+
## Install WSL2
31
+
32
+
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.
33
+
34
+
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`.
35
+
This will open a window where you can turn Windows features on/off.
36
+
Make sure that the below features are activated (checked):
37
+
38
+
*`Hyper-V` (including its sub-features)
39
+
*`Virtual Machine Platform`
40
+
*`Windows Subsystem for Linux`
41
+
42
+
> If any of the above features are missing, then first you need to install them manually using [this guide](https://docs.microsoft.com/en-us/windows/wsl/install-manual) and then continue with the below steps.
43
+
44
+
Click `Ok` and restart your computer.
45
+
46
+
Open Microsoft Store, search for `Windows Subsystem for Linux` and install it.
47
+
48
+
Make sure that version **2** of WSL is set as default by executing the below command in Windows Terminal:
49
+
50
+
```shell
51
+
wsl --set-default-version 2
52
+
```
53
+
54
+
To test, run again the following command:
55
+
56
+
```shell
57
+
wsl -v
58
+
```
59
+
60
+
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 AlmaLinux9](wsl/README.md).
Open Microsoft Store, in the search box type in: `AlmaLinux` and hit `Enter`.
5
+
List the available Linux distributions (aka: _distros_) by executing:
6
6
7
-
From the results, select **AlmaLinux OS 9** this will take you to **AlmaLinux9**'s app page.
7
+
```shell
8
+
wsl --list --online
9
+
```
10
+
11
+
Depending on the list of distros available at the moment you run the command, the output should look similar to the below:
12
+
13
+
```text
14
+
The following is a list of valid distributions that can be installed.
15
+
Install using 'wsl.exe --install <Distro>'.
16
+
17
+
NAME FRIENDLY NAME
18
+
AlmaLinux-8 AlmaLinux OS 8
19
+
AlmaLinux-9 AlmaLinux OS 9
20
+
AlmaLinux-Kitten-10 AlmaLinux OS Kitten 10
21
+
AlmaLinux-10 AlmaLinux OS 10
22
+
Debian Debian GNU/Linux
23
+
FedoraLinux-42 Fedora Linux 42
24
+
SUSE-Linux-Enterprise-15-SP5 SUSE Linux Enterprise 15 SP5
25
+
SUSE-Linux-Enterprise-15-SP6 SUSE Linux Enterprise 15 SP6
26
+
Ubuntu Ubuntu
27
+
Ubuntu-24.04 Ubuntu 24.04 LTS
28
+
archlinux Arch Linux
29
+
kali-linux Kali Linux Rolling
30
+
openSUSE-Tumbleweed openSUSE Tumbleweed
31
+
openSUSE-Leap-15.6 openSUSE Leap 15.6
32
+
Ubuntu-18.04 Ubuntu 18.04 LTS
33
+
Ubuntu-20.04 Ubuntu 20.04 LTS
34
+
Ubuntu-22.04 Ubuntu 22.04 LTS
35
+
OracleLinux_7_9 Oracle Linux 7.9
36
+
OracleLinux_8_7 Oracle Linux 8.7
37
+
OracleLinux_9_1 Oracle Linux 9.1
38
+
```
8
39
9
-
On this page, locate and click the `Install` button - this will download **AlmaLinux9** WSL2 image on your system.
40
+
Note the two columns: **NAME** and **FRIENDLY NAME**.
41
+
To install a specific distro, use the value from the **NAME** column, in this case: `AlmaLinux-9`.
42
+
Install the AlmaLinux9 distro by executing the below command:
10
43
11
-
Once the download has finished, the `Install` button is replaced by an `Open` button - clicking it will open `Windows Terminal`.
44
+
```shell
45
+
wsl --install -d AlmaLinux-9
46
+
```
12
47
13
-
Here you will be asked to fill in your username (for example `dotkernel`):
48
+
You should see the download progress - once finished, the output should look like this:
14
49
15
50
```text
16
-
Installing, this may take a few minutes...
51
+
Downloading: AlmaLinux OS 9
52
+
Installing: AlmaLinux OS 9
53
+
Distribution successfully installed. It can be launched via 'wsl.exe -d AlmaLinux-9'
54
+
Launching AlmaLinux-9...
17
55
Please create a default UNIX user account. The username does not need to match your Windows username.
18
56
For more information visit: https://aka.ms/wslusers
19
57
Enter new UNIX username:
20
58
```
21
59
22
-
Next, you are prompted to enter a password to use with your username (you will not see what you are typing, that's a security measure in Linux regarding passwords):
60
+
As per the last line, the installation process now prompts you to enter a username.
61
+
This is the username you will use inside AlmaLinux9, and it can be any alphanumeric string (for example `dotkernel`):
23
62
24
-
```text
63
+
Next, you are prompted to change the password associated with your chosen username (you will not see what you are typing, that's a security measure in Linux regarding passwords):
64
+
65
+
```shell
25
66
Enter new UNIX username: dotkernel.
26
67
Changing password for user dotkernel.
27
68
New password:
28
69
```
29
70
30
-
Depending on the strength of your password, you might see one of the following messages (if you want to choose a different password, hit `Enter` and you are taken back to previous step - else, continue with retyping your password).
31
-
32
-
```text
33
-
BAD PASSWORD: The password fails the dictionary check - it is based on a dictionary word
34
-
BAD PASSWORD: The password is a palindrome
35
-
```
71
+
Depending on the strength of your password, you might get a `BAD PASSWORD: <some-reason>` message (if you want to choose a different password, hit `Enter` and you are taken back to previous step - else, continue with retyping your password):
36
72
37
73
Next, you are asked to retype your password:
38
74
@@ -44,6 +80,5 @@ Finally, you should see the following message:
44
80
45
81
```text
46
82
passwd: all authentication tokens updated successfully.
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).
10
10
11
-
```shell
12
-
sudo dnf upgrade -y
13
-
```
11
+
```text
12
+
We trust you have received the usual lecture from the local System Administrator. It usually boils down to these three things:
14
13
15
-
Now, install the latest version of **Ansible**:
14
+
#1) Respect the privacy of others.
15
+
#2) Think before you type.
16
+
#3) With great power comes great responsibility.
16
17
17
-
```shell
18
-
sudo dnf install ansible -y
18
+
[sudo] password for dotkernel:
19
19
```
20
20
21
-
Clone `dotkernel/development` into your home directory:
The installation process will ask for your password (set during the installation process) and will iterate over each task in the playbook and will output a short summary with the results.
46
-
47
-
At this step, **AlmaLinux9** needs to be restarted; quit it by pressing `Control` + `d`.
48
-
49
-
Open `Windows Terminal`.
50
-
51
-
Stop **AlmaLinux9**:
41
+
Clone the `almalinux9` branch of the `dotkernel/development` repository:
The installation process will ask for your password (set during the installation process) and will iterate over each task in the playbook and will output a short summary with the results.
68
+
The installation process will ask for your AlmaLinux9 password, then iterate over each task in the playbook and output a short summary with the results.
76
69
77
-
Now check if everything works by opening in your browser:
70
+
Once finished, check if everything works by opening in your browser:
78
71
79
72
*[http://localhost/](http://localhost/): Apache's default home page
80
73
*[http://localhost/info.php](http://localhost/info.php): PHP info page
81
74
*[http://localhost/phpmyadmin/](http://localhost/phpmyadmin/): PhpMyAdmin (login with `root` + the root password you configured in `config.yml` under `mariadb` -> `root_password`)
82
75
83
-
The installation is complete, your **AlmaLinux9** development environment is ready to use.
76
+
The installation is complete, your AlmaLinux9 development environment is ready to use.
77
+
78
+
> 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 **AlmaLinux9**.
84
79
85
80
## Running AlmaLinux9
86
81
87
82
Open `Windows Terminal`.
88
83
89
-
Start **AlmaLinux9**:
84
+
Start AlmaLinux9 by executing:
90
85
91
86
```shell
92
87
wsl -d AlmaLinux9
93
88
```
94
89
90
+
OR
91
+
92
+
Locate the app selector dropdown in `Windows Terminal`'s title bar and click `AlmaLinux-9`.
93
+
This will open a new tab connected to AlmaLinux9.
94
+
95
95
### Note
96
96
97
97
> To run your applications using WSL2, you always need to be connected to your AlmaLinux9 distribution.
Copy file name to clipboardExpand all lines: docs/book/v1/setup/system-requirements.md
+14-11Lines changed: 14 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,11 @@
1
-
# System Requirements
1
+
# System requirements
2
2
3
-
First, you need to check if your system is ready for using **WSL2**. Open `Windows Terminal` and execute the following command:
3
+
If you're not already using it, we recommend you to install [Windows Terminal](https://apps.microsoft.com/detail/9n0dx20hk701?hl=en-US&gl=US).
4
+
It is a modern tool that incorporates the power of multiple already known command-line applications like `Windows PowerShell`, `Linux shell`, and more...
5
+
6
+
## Check if WLS2 is already available
7
+
8
+
Open `Windows Terminal` and execute the following command:
If the output starts with `WSL version: 2.x`, you are ready to use **WSL2** and can continue with [the installation](installation.md).
26
+
If the output starts with `WSL version: 2.x.x.x`, you are ready to use **WSL2** and can proceed to [install AlmaLinux9](installation.md).
22
27
23
-
Else, you need to install **WSL2** and its components as shown below.
28
+
## Install WSL2
24
29
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**.
26
-
27
-
Once you know that your system can run **WSL2**, open the `Run` prompt by pressing `Win`+`r` and type in the dialog `OptionalFeatures`, then press `Enter`.
30
+
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.
28
31
32
+
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`.
29
33
This will open a window where you can turn Windows features on/off.
30
-
31
-
Make sure the next features are activated (checked):
34
+
Make sure that the below features are activated (checked):
32
35
33
36
*`Hyper-V` (including its sub-features)
34
37
*`Virtual Machine Platform`
@@ -40,7 +43,7 @@ Click `Ok` and restart your computer.
40
43
41
44
Open Microsoft Store, search for `Windows Subsystem for Linux` and install it.
42
45
43
-
Make sure **WSL2** is set as default by executing the below command in `Windows Terminal`:
46
+
Make sure that version **2**of WSL is set as default by executing the below command in Windows Terminal:
44
47
45
48
```shell
46
49
wsl --set-default-version 2
@@ -52,4 +55,4 @@ To test, run again the following command:
52
55
wsl -v
53
56
```
54
57
55
-
This time the output should display `WSL version: 2.x`, which means that your system is ready for using **WSL2** and you can continue with the [installation](installation.md).
58
+
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 AlmaLinux9](installation.md).
Copy file name to clipboardExpand all lines: docs/book/v1/virtualhosts/create-virtualhost.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,6 +35,6 @@ You will install your project under the `html` directory of your project, for ex
35
35
* To run your installed projects, you need to start AlmaLinux9 first.
36
36
* If you work with virtualhosts, your projects are created under `/var/www/`.
37
37
* You can still run PHP scripts under the default Apache project directory, located at `/var/www/html/`.
38
-
* If you encounter write permission issues, see [this guide](../faq.md#how-do-i-fix-common-permission-issues).
39
-
*This tool installs PHP 8.3 by default. If you need a different version, see [this guide](../faq.md#how-do-i-switch-to-a-different-version-of-php).
40
-
*This tool installs Node.js 22 by default. If you need a different version, see [this guide](../faq.md#how-do-i-switch-to-a-different-version-of-nodejs).
38
+
* If you encounter write permission issues, see [this guide](https://docs.dotkernel.org/development/almalinux9/faq/#how-do-i-fix-common-permission-issues).
39
+
*We install PHP 8.3 by default - if you need a different version, see [this guide](https://docs.dotkernel.org/development/almalinux9/faq/#how-do-i-switch-to-a-different-version-of-php).
40
+
*We install Node.js 22 by default - if you need a different version, see [this guide](https://docs.dotkernel.org/development/almalinux9/faq/#how-do-i-switch-to-a-different-version-of-nodejs).
0 commit comments