Joomla Vagrant Testing box

This vagrant box allows you to easily run and create tests for the Joomla CMS.

For more details on tests see https://github.com/joomla/joomla-cms/tree/staging/tests/codeception

Specs:

• Ubuntu 14.04 LTS
• Fluxbox
• Apache 2.4
• PHP 7
• Joomla repository
• MySQL 5.7
• OpenJDK 8 (needed for selenium)
• Joomla staging
• Firefox & Chrome

Installation

Install Vagrant (available for all major operating systems) and navigate with the terminal (or cmd) to this directory.

vagrant up

The initial setup is, depending on your internet connection speed, going to take some time. It's normal for VirtualBox to show up, please don't login and wait for the installation to finish.

Update

Updating to the latest version

When new versions of the box are released you can update your local machine by executing:

vagrant box update

Note that updating the box will not update an already-running Vagrant machine. To reflect the changes in the box, you will have to destroy (vagrant destroy) and bring back up the Vagrant machine (vagrant up).

Run tests

Right click on the desktop to open the Fluxbox menu. Choose Joomla -> XTerm to open the Terminal.

Execute runtests to run all tests.

Manually

Navigate with the terminal to cd /joomla/install and run tests/codeception/vendor/bin/robo run:tests

You can also run a single test afterwards with:

tests/codeception/vendor/bin/robo run:test

Add / edit tests

Just open ./joomla/install directory in your hosts local IDE, like PhpStorm. The directory is mounted to the vagrant virtual machine.

Port mapping

If you want to open the site with your hosts browser just navigate to http://localhost:4242 or http://10.42.0.2

Passwords

For the joomla user: joomla

Root user: vagrant

The joomla can also use sudo

Folder mapping

/joomla on the vagrant machine is mapped to the hosts ./joomla directory

Troubleshooting

/joomla is empty for me: Mount it manually with mount joomla /joomla -t vboxsf