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
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).
9
8
10
-
It's a modern tool that incorporates the power of multiple already known command-line applications like
11
-
`Windows PowerShell`, `Linux shell`, and more...
9
+
It's a modern tool that incorporates the power of multiple already known command-line applications like `Windows PowerShell`, `Linux shell`, and more...
12
10
13
-
## How it works?
11
+
## Setup
14
12
15
-
Choose a tool from the below list, and we will guide you through the steps that will install and configure it for you.
Copy file name to clipboardExpand all lines: docs/book/v1/setup/installation.md
+6-9Lines changed: 6 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,15 +1,14 @@
1
1
# Installation
2
2
3
-
## Install AlmaLinux 9
3
+
## Install AlmaLinux9
4
4
5
5
Open Microsoft Store, in the search box type in: `AlmaLinux` and hit `Enter`.
6
6
7
-
From the results, select **AlmaLinux 9**- this will take you to **AlmaLinux 9**'s app page.
7
+
From the results, select **AlmaLinux OS 9** this will take you to **AlmaLinux9**'s app page.
8
8
9
-
On this page, locate and click the `Install` button - this will download **AlmaLinux 9**WSL image on your system.
9
+
On this page, locate and click the `Install` button - this will download **AlmaLinux9**WSL2 image on your system.
10
10
11
-
Once the download has finished, the `Install` button is replaced by an `Open` button - clicking it will open
12
-
`Windows Terminal`.
11
+
Once the download has finished, the `Install` button is replaced by an `Open` button - clicking it will open `Windows Terminal`.
13
12
14
13
Here you will be asked to fill in your username (for example `dotkernel`):
15
14
@@ -20,17 +19,15 @@ For more information visit: https://aka.ms/wslusers
20
19
Enter new UNIX username:
21
20
```
22
21
23
-
Next, you are prompted to enter a password to use with your username (you will not see what you are typing, that's a
24
-
security measure in Linux regarding passwords):
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):
25
23
26
24
```text
27
25
Enter new UNIX username: dotkernel.
28
26
Changing password for user dotkernel.
29
27
New password:
30
28
```
31
29
32
-
Depending on the strength of your password, you might see one of the following messages (if you want to choose a
33
-
different password, hit `Enter` and you are taken back to previous step - else, continue with retyping your password).
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).
34
31
35
32
```text
36
33
BAD PASSWORD: The password fails the dictionary check - it is based on a dictionary word
The installation process will ask for your password (set during the installation process) and will iterate over each
44
-
task in the playbook and will output a short summary with the results.
43
+
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.
45
44
46
-
At this step, **AlmaLinux 9** needs to be restarted - quit it by pressing `Control` + `d`.
45
+
At this step, **AlmaLinux9** needs to be restarted; quit it by pressing `Control` + `d`.
47
46
48
47
Open `Windows Terminal`.
49
48
50
-
Stop **AlmaLinux 9**:
49
+
Stop **AlmaLinux9**:
51
50
52
51
```shell
53
52
wsl -t AlmaLinux9
54
53
```
55
54
56
-
Start **AlmaLinux 9**:
55
+
Start **AlmaLinux9**:
57
56
58
57
```shell
59
58
wsl -d AlmaLinux9
@@ -65,35 +64,33 @@ Move inside the directory `development/wsl`:
65
64
cd~/development/wsl/
66
65
```
67
66
68
-
Continue installation by running the below Ansible command:
67
+
Continue the installation by running the below Ansible command:
The installation process will ask for your password (set during the installation process) and will iterate over each
75
-
task in the playbook and will output a short summary with the results.
73
+
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.
76
74
77
75
Now check if everything works by opening in your browser:
78
76
79
-
-[http://localhost/](http://localhost/) - Apache's default home page
80
-
-[http://localhost/info.php](http://localhost/info.php) - PHP info page
81
-
-[http://localhost/phpmyadmin/](http://localhost/phpmyadmin/) - PhpMyAdmin (login with `root` + the root password you
82
-
configured in `config.yml` under `mariadb` -> `root_password`)
77
+
*[http://localhost/](http://localhost/): Apache's default home page
78
+
*[http://localhost/info.php](http://localhost/info.php): PHP info page
79
+
*[http://localhost/phpmyadmin/](http://localhost/phpmyadmin/): PhpMyAdmin (login with `root` + the root password you configured in `config.yml` under `mariadb` -> `root_password`)
83
80
84
-
The installation is complete, your **AlmaLinux 9** development environment is ready to use.
81
+
The installation is complete, your **AlmaLinux9** development environment is ready to use.
85
82
86
-
## Running AlmaLinux 9
83
+
## Running AlmaLinux9
87
84
88
85
Open `Windows Terminal`.
89
86
90
-
Start **AlmaLinux 9**:
87
+
Start **AlmaLinux9**:
91
88
92
89
```shell
93
90
wsl -d AlmaLinux9
94
91
```
95
92
96
93
### Note
97
94
98
-
> In order to run your applications using WSL2, you always need to be connected to your AlmaLinux9 distribution.
95
+
> To run your applications using WSL2, you always need to be connected to your AlmaLinux9 distribution.
99
96
> For this, all you need to do is to keep open an instance of Windows Terminal that is connected to it.
If the output starts with `WSL version: 2.x`, you are ready to use **WSL2** and can continue with
23
-
[the installation](installation.md).
21
+
If the output starts with `WSL version: 2.x`, you are ready to use **WSL2** and can continue with [the installation](installation.md).
24
22
25
-
Else, you need to install **WSL2** and it's components as shown below.
23
+
Else, you need to install **WSL2** and its components as shown below.
26
24
27
-
Before proceeding with the installation, please consult Microsoft's
28
-
[documentation](https://learn.microsoft.com/en-us/windows/wsl/install#prerequisites) regarding the minimum requirements
29
-
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 **WSL2**.
30
26
31
-
Once you know that your system can run **WSL2**, open the `Run` prompt by pressing `Win`+`r` and type in the dialog
32
-
`OptionalFeatures`, then press `Enter`.
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`.
33
28
34
29
This will open a window where you can turn Windows features on/off.
35
30
36
31
Make sure the next features are activated (checked):
37
32
38
-
-`Hyper-V` (including its sub-features)
39
-
-`Virtual Machine Platform`
40
-
-`Windows Subsystem for Linux`
33
+
*`Hyper-V` (including its sub-features)
34
+
*`Virtual Machine Platform`
35
+
*`Windows Subsystem for Linux`
41
36
42
-
> If any of the above features is missing, then first you need to install them manually using
43
-
> [this guide](https://docs.microsoft.com/en-us/windows/wsl/install-manual) and then continue with the below steps.
37
+
> 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.
44
38
45
39
Click `Ok` and restart your computer.
46
40
@@ -58,5 +52,4 @@ To test, run again the following command:
58
52
wsl -v
59
53
```
60
54
61
-
This time the output should display `WSL version: 2.x`, which means that your system is ready for using **WSL2** and you
62
-
can continue with the [installation](installation.md).
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).
0 commit comments