The Bug Genie

Build Status Join the chat at

The Bug Genie is an enterprise-grade issue-tracking, development and project management system. Main features includes:

... and a lot more!

For up-to-date installation and setup notes, visit the FAQ:


1: Download and install Composer

The Bug Genie uses a dependency resolution tool called Composer, which must be downloaded and run before The Bug Genie can be installed or used.

Download and install Composer from

2: Install The Bug Genie dependencies

After you have followed the instructions in step 1, run php composer.phar install from the main directory of The Bug Genie. Composer will download and install all necessary components for The Bug Genie, and you can continue to the actual installation as soon as it is completed.

3a: Install via web

Visit the subfolder in your web-browser.

The installation script will start automatically and guide you through the installation process.

3b: Install via command-line (unix/linux only)

You can use the included command-line client to install, if you prefer that. The command line utility can be found in the root folder: $ php ./tbg_cli

To install: $ ./tbg_cli install


If you find any issues, please report them in the issue tracker on our website:


By executing composer.phar install --dev during the installation process, phpunit 4.2 will get installed. The phpunit test can be run by the following command:


Development and testing using Vagrant

If you are interested in contributing some code to The Bug Genie, you can get quickly up and running using the provided Vagrant and Ansible configuration. This can save you both time, and reduce the number of software packages you need to install and configure for working with The Bug Genie.

Take note that provided configuration and set-up should not be used in production.

For more details and some introduction see The Bug Genie wiki page.