Run tests for Joomla! CMS in this ready to go Vagrant box!
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

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


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


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.


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.


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


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


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