Info | HTML | Text

Documentation - Installation

This section describes how to install CruiseControl and phpUnderControl. If you have read the following lines you should be able to set up your own continuous integration environment for PHP development.

Setting up CruiseControl and phpUnderControl

The first things you need is a Java environment and a working installation of CruiseControl. I assume that Java is already installed and so I will not cover this topic here, but I suggest to use an original Java version from SUN instead of some versions bundled with linux distributions, because in combination with compiz or beryl the metrics view may be broken otherwise.

Setting up a working CruiseControl installation is a really simple task. Just download one of the provided zip archives from the project site, unpack the contents into an arbitrary folder and start the application. For a detailed installation description how to install CruiseControl and how to configure it with PHPUnit I recommend an excellent article by Sebastian Nohn and the Continuous Integration chapter from the PHPUnit Pocket Guide.

Please note the CruiseControl tutorial uses version 2.4.*, but the current version is 2.8.*. So please install an up to date version, because it is required by phpUnderControl!

Now that you have a working CruiseControl, check out phpUnderControl from its repository hosted on github.

git clone git://

Now you can patch your CruiseControl installation by entering

phpUnderControl/bin/phpuc(.php|.bat) install /path/to/cruisecontrol

This command will exchange some template and the original metric charts and it installs additional resources.

That's it.