Skip to content

Commit 7d455c4

Browse files
committed
Fix virtualhost flow accuracy and clarify the two-step setup process
- Drop redundant "AlmaLinux 10 " title prefixes. - Fix wrong virtualhost config path: the file Ansible actually writes is example.localhost.conf, not example.localhost. - Fix missing noun ("...list of configured, and output..." -> "...list of configured virtualhosts, and output..."). - Fix hyphen-flattened em dashes, and phrase the PHP default version by pointing at wsl/roles/php/tasks/main.yml instead of hardcoding a number that will drift again. - Fix absolute docs.dotkernel.org cross-links to relative paths. - Clarify that provisioning is two independent, repeatable steps: install.yml sets up the server-wide stack once; creating a virtualhost per project is separate and can be repeated any time. Reworded create-virtualhost.md's summary and setup-packages.md's config.virtualhosts field + "Next step" section accordingly. - Add a short security-framing note to setup-packages.md: this stack is local-development-only, with a plaintext MariaDB root password and root-login phpMyAdmin exposed at a predictable path.
1 parent fb4e858 commit 7d455c4

3 files changed

Lines changed: 17 additions & 13 deletions

File tree

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

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# AlmaLinux 10 Setup
1+
# Setup
22

33
## Summary
44

@@ -88,7 +88,9 @@ Using your preferred text editor, open `config.yml` and fill in the empty fields
8888
* `config.git.config."user.name"` / `"user.email"`: the identity Git will use for your commits inside AlmaLinux 10.
8989
* `config.mariadb.root_password`: the password to set for MariaDB's `root` user (you'll use this to log into phpMyAdmin later).
9090
* `config.system.username`: defaults to your current AlmaLinux 10 username automatically, usually no change needed.
91-
* `config.virtualhosts`: a list of local domains to create virtualhosts for (see [Virtualhosts](../virtualhosts/overview.md)); the default entry `example.localhost` can be removed or left as-is.
91+
* `config.virtualhosts`: an optional starter list of local domains to create a virtualhost for during this same run; the default entry `example.localhost` can be removed or left as-is. You do not need to list every project here — see [Create a virtualhost](../virtualhosts/create-virtualhost.md) to add one at any time after setup, without re-running this step.
92+
93+
> This environment is intended for **local development only**, not production or network-exposed use — security is relaxed or effectively nonexistent by default. `config.mariadb.root_password` is stored in plaintext in this gitignored, local-only `config.yml`, and phpMyAdmin is exposed at `/phpmyadmin` with root login. That's acceptable for a local dev box, but this stack should never be exposed to a network.
9294
9395
Save and close the file.
9496

@@ -115,7 +117,7 @@ The installation is complete, your **AlmaLinux 10** development environment is r
115117
116118
## Next step
117119

118-
Your environment is now provisioned. Continue to [Running on WSL 2](../running.md) to learn how to (re)connect to your **AlmaLinux 10** distro, or jump straight to [Virtualhosts](../virtualhosts/overview.md) to host your first project.
120+
`install.yml` provisions the server-wide stack (Apache, PHP, MariaDB, phpMyAdmin, Composer, Node.js) — a one-time step you don't need to repeat. Creating a virtualhost for a project is a separate, repeatable step: continue to [Running on WSL 2](../running.md) to learn how to (re)connect to your **AlmaLinux 10** distro, or jump straight to [Create a virtualhost](../virtualhosts/create-virtualhost.md) whenever you're ready to host a project — you can come back and repeat that step for every new project.
119121

120122
## FAQ
121123

‎docs/book/v2/virtualhosts/create-virtualhost.md‎

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,9 @@
1-
# AlmaLinux 10 Create virtualhosts
1+
# Create virtualhosts
22

33
## Summary
44

5+
Provisioning your **AlmaLinux 10** environment is a two-step process: `install.yml` sets up the server-wide stack once (Apache, PHP, MariaDB, phpMyAdmin, Composer, Node.js); creating a virtualhost for each project is a separate, repeatable step that you run as needed, any time after that — this page covers that second step.
6+
57
Add your desired domains to `config.yml` and run the `create-virtualhost.yml` Ansible playbook to provision each one.
68

79
> By using the `*.localhost` pattern for any new virtualhost, you do not need to modify the `hosts` file in Windows, because these are routed by default.
@@ -34,14 +36,14 @@ Create the specified virtualhosts:
3436
ansible-playbook -i hosts create-virtualhost.yml --ask-become-pass
3537
```
3638

37-
This process will ask for your **AlmaLinux 10** password, iterate over the list of configured, and output a short summary with the results.
39+
This process will ask for your **AlmaLinux 10** password, iterate over the list of configured virtualhosts, and output a short summary with the results.
3840
Your virtualhost should be accessible and ready to use.
3941

4042
You will install your project under the `html` directory of your project, for example `/var/www/example.localhost/html`.
4143

4244
> The virtualhost's document root is set to the `public` directory of the above location, for example `/var/www/example.localhost/html/public`.
4345
44-
> If you want to have the DocumentRoot directly in `html` folder, you need to modify the file `/etc/httpd/sites-available/example.localhost`.
46+
> If you want to have the DocumentRoot directly in `html` folder, you need to modify the file `/etc/httpd/sites-available/example.localhost.conf`.
4547
4648
> A freshly created virtualhost only has an empty `html` directory - `html/public` doesn't exist yet.
4749
> Visiting the virtualhost's URL in your browser will show an error until you place a project there, this is expected.
@@ -54,9 +56,9 @@ You will install your project under the `html` directory of your project, for ex
5456
* To run your installed projects, you need to start **AlmaLinux 10** first.
5557
* If you work with virtualhosts, your projects are created under `/var/www/`.
5658
* You can still run PHP scripts under the default Apache project directory, located at `/var/www/html/`.
57-
* If you encounter write permission issues, see [this guide](https://docs.dotkernel.org/development/v2/faq/#how-do-i-fix-common-permission-issues).
58-
* We install PHP 8.4 by default-if you need a different version, see [this guide](https://docs.dotkernel.org/development/v2/faq/#how-do-i-switch-to-a-different-version-of-php).
59-
* We install Node.js 22 by default-if you need a different version, see [this guide](https://docs.dotkernel.org/development/v2/faq/#how-do-i-switch-to-a-different-version-of-nodejs).
59+
* If you encounter write permission issues, see [this guide](../faq.md#how-do-i-fix-common-permission-issues).
60+
* We install the PHP version pinned in `wsl/roles/php/tasks/main.yml` (currently 8.5) by default — if you need a different version, see [this guide](../faq.md#how-do-i-switch-to-a-different-version-of-php).
61+
* We install 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).
6062

6163
## FAQ
6264

@@ -82,7 +84,7 @@ The document root is set to the `public` subdirectory of that location, for exam
8284

8385
**Q: How do I make the DocumentRoot point directly to `html` instead of `html/public`?**
8486

85-
A: Edit the virtualhost's Apache configuration file at `/etc/httpd/sites-available/example.localhost` and change the `DocumentRoot` accordingly.
87+
A: Edit the virtualhost's Apache configuration file at `/etc/httpd/sites-available/example.localhost.conf` and change the `DocumentRoot` accordingly.
8688

8789
**Q: How do I access my virtualhost if AlmaLinux 10 isn't running?**
8890

@@ -91,8 +93,8 @@ Your virtualhosts are only reachable while the distro is running.
9193

9294
**Q: What if I hit permission errors when writing to my project's files?**
9395

94-
A: See the [permission issues guide](https://docs.dotkernel.org/development/v2/faq/#how-do-i-fix-common-permission-issues) in the FAQ.
96+
A: See the [permission issues guide](../faq.md#how-do-i-fix-common-permission-issues) in the FAQ.
9597

9698
**Q: How do I delete a virtualhost I no longer need?**
9799

98-
A: See [How do I delete a virtualhost?](https://docs.dotkernel.org/development/v2/faq/#how-do-i-delete-a-virtualhost) in the FAQ.
100+
A: See [How do I delete a virtualhost?](../faq.md#how-do-i-delete-a-virtualhost) in the FAQ.

‎docs/book/v2/virtualhosts/overview.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# AlmaLinux 10 Overview
1+
# Overview
22

33
## Summary
44

0 commit comments

Comments
 (0)