Vagrant box Rocky Linux 8 LAMP

Make a Vagrant box with Rocky Linux 8 LAMP stack, plus configure it for development.

• Host: Linux or Mac.

• Guest: Rocky Linux 8.7, Apache 2.4, MariaDB 10.6, PHP 8.2, Python 3.9, Ruby 3.1.3, Git 2+.

• Leave code and version control files physically outside the VM while virtually accessing them inside the VM.

• Use any GUI tool (IDEs, browsers, database administration applications, Git clients) outside the VM to access code and data inside the VM.

---

Details

Read Stemar Vagrant boxes.

Summary

VM = virtual machine

Quick installation

In host machine terminal:

mkdir -p ~/VM && cd $_
git clone --depth=1 https://github.com/stemar/vagrant-rockylinux-8.git rockylinux-8
cd ~/VM/rockylinux-8
vagrant up --provision
vagrant ssh

Steps

• Prerequisites
• Vagrant preparation
• Virtual machine provisioning
• Configuration checks

Result

• 64bit Rocky Linux 8.7 virtual machine with virtual 64GB HDD, 3GB RAM and updated LAMP stack from Bento.
• Custom .bashrc to modify bash settings inside the virtual machine.
• Configure LAMP settings from the host machine instead of inside the virtual machine.
• Provisioning in bash because the commands can easily be copied/pasted inside a VM or server for troubleshooting.
• Keep multiple Vagrant boxes in a separate location than your projects/code location.
  • .vagrant/ is created independently within each VM directory.
  • Multiple Vagrant boxes can be run concurrently from separate terminal tabs.
  • Avoid port collision by editing :forwarded_ports values in settings.yaml.
• Copied SSH keys to use the same in and out of VM.
• Copied Git configuration to use the same in and out of VM.
• Synchronized projects/code directories.
• Apache serves any local website at http://domain.com.localhost:8000 with VirtualDocumentRoot.
• Add more VirtualHost blocks from the host machine and re-provision the Vagrant box.
• MariaDB and Adminer with no password for username root.
  • Avoid writing a password a zillion times through development.
• Adminer served at http://localhost:8000/adminer.php.
• Development-specific php.ini settings from .htaccess for all local websites.
• Python 3.9 installed.
• Option to install Ruby with rbenv.
• Option to install Bundler.

---

Prerequisites

• VirtualBox 6+
• VirtualBox 6+ Extension Pack
• Vagrant 2+

SSH keys and Git config settings from host machine are copied in virtual machine.

Check if you have them on your host machine:

ll ~/.ssh
cat ~/.gitconfig

---

Vagrant preparation

Edit values in settings.yaml.

• Edit the :machine values if necessary.
• Add arrays to the :forwarded_ports value if necessary.
  • Ex.: Change the forwarded ports of this virtual machine to avoid port collision if you have multiple virtual machines running at the same time.
• Change :synced_folder values to match your host machine pathname.
• Edit the :copy_files values:
• Edit the :php_error_reporting value if necessary.
• Uncomment the :ruby_version value if you want to install rbenv, Bundler and Ruby.
• Edit the :ruby_version value if necessary.

Edit config files if needed.

• Edit the VirtualDocumentRoot public directory value in virtualhost.conf.
• Add VirtualHosts in virtualhost.conf.
• Edit php.ini.htaccess values.
• Add/edit lines to bashrc.

Edit provision.sh if needed.

• Add/edit Linux tools.
• Add/edit PHP libraries.
• Add Ruby gems.
• Add anything you need.

---

Virtual machine provisioning

Provision the box from the host machine terminal:

cd ~/VM/rockylinux-8
vagrant up --provision

To halt the box:

vagrant halt -f

To boot the box without provisioning:

vagrant up

If anything goes wrong:

vagrant destroy -f
vagrant box update
vagrant up --provision

Check the status of all Vagrant machines on your host machine:

vagrant global-status

Connect to the box through SSH:

vagrant ssh

Bash prompt in virtual machine is now:

[vagrant@rockylinux-8 ~]$

---

Configuration checks

Check LAMP settings

Check synchronized folders:

ll ~/Code
ll /vagrant

Check versions:

cat /etc/redhat-release
httpd -V
mysql -V
php -v
python3 --version
ruby -v
git --version
openssl version
curl --version

Check Apache configuration:

apachectl configtest
httpd -D DUMP_VHOSTS
cat /etc/hosts
cat /etc/httpd/conf/httpd.conf
ll /etc/httpd/conf.d
cat /etc/httpd/conf.d/php.conf
cat /etc/httpd/conf.d/ssl.conf
cat /etc/httpd/conf.d/localhost.conf
cat /etc/httpd/conf.d/virtualhost.conf
cat /etc/httpd/conf.d/adminer.conf
sudo cat /etc/httpd/logs/error_log

Check MariaDB databases:

mysql -u root
MariaDB [(none)]> SHOW DATABASES; quit;

Check PHP modules and variables:

php -m
php -i

Browse local websites

Check localhost

http://localhost:8000

You see the default Rocky Linux "HTTP Server Test Page".

Check Adminer

http://localhost:8000/adminer.php

• Username: root
• Password: leave empty

Check your domain(s)

Replace domain.com with your domain and your custom forwarded port number.

http://domain.com.localhost:8000

---