Table of Contents
On this page

Create virtualhosts

Move inside the directory development/wsl:

cd ~/development/wsl/

If you don't already have a config.yml file, duplicate config.yml.dist as config.yml.

Using your preferred text editor, open config.yml and, under the virtualhosts key, enter the virtualhosts that you want to create, each on its own line.

Already existing virtualhosts will be skipped, their contents will not be lost, no need to comment or remove them.

Save and close the file.

Create the specified virtualhosts:

ansible-playbook -i hosts create-virtualhost.yml --ask-become-pass

This process will ask for your password (set during the installation process) and then iterate over the list of configured virtualhosts and will output a short summary with the results.

Your virtualhost should be accessible and ready to use.

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

The virtualhost's document root is set to the public directory of the above location, for example /var/www/example.localhost/html/public.

If you want to have the DocumentRoot directly in html folder, you need to modify the file /etc/httpd/sites-available/example.localhost.

Good to know

  • To run your installed projects, you need to start AlmaLinux9 first.
  • If you work with virtualhosts, your projects are created under /var/www/.
  • You can still run PHP scripts under the default Apache project directory, located at /var/www/html/.
  • If you encounter write permission issues, see this guide.
  • We install PHP 8.3 by default—if you need a different version, see this guide.
  • We install Node.js 22 by default—if you need a different version, see this guide.