In this post I will describe how to install the free and powerful IT / development management tool The Bug Genie on Hyper-V 2008 R2 VM (or similar hypervisors) with guest OS Ubuntu 12.04 LTS and LDAP / Active Directory authentification.

First, create a new virtual machine in the environment of your choice, e.g. with a 50 GB HDD. In Hyper-V, you can leave all settings by default.

Download Ubuntu (Server Edition recommended).

Install Ubuntu on your new VM (“insert” the .iso File in the virtual drive, power on the VM and follow the setup instructions). Choose OpenSSH server to be enabled.

Log in (locally or remote).

Run “sudo -s” and enter your root password.

Then run:

apt-get update

apt-get upgrade

apt-get install php5

apt-get install phpmyadmin

apt-get install postfix

Note the password which you chose for phpMyAdmin and the root DB user.

Look for the TBG zip file download path.

wget [direct_path_to_zip_file]

(You can also download the file via your browser and then transfer it to your VM via WinSCP etc.)

cd /var/www

unzip [downloaded_zip_file]

Make sure index.php is now under /var/www/thebuggenie. If you got another subfolder “thebuggenie”, move the files 1 directory upwards.

chown -R www-data /var/www

Open http://[name_or_IP_of_your_VM]/phpmyadmin, log in with root credentials. Create a new database, e.g. “tbg” and a user, set a password and full permissions to your new DB.

Open http://[name_or_IP_of_your_VM/thebuggenie and fill in the DB data fields etc. The setup process is quite simple.

Even if the TBG setup does not show any errors, you might want mod_rewrite to be enabled:

a2enmod rewrite

Then we have to modify the default apache settings:

vi /etc/apache2/sites-enabled/000-default

Set every “AllowOverride” line to “All”, then restart Apache:

service apache2 restart

Bugfix for IE and TBG version Open /var/www/core/templates/layout.php and add the following line, e.g. at line 8:

<meta http-equiv=”X-UA-Compatible” content=”IE=9″>

Now you can open the Web GUI of The Bug Genie and everything should work.

LDAP / AD integration

Open your TBG web interface with Admin credentials. Go to the configuration area -> Modules -> Install new modules. You should find the LDAP module there and enable and configure it. The screenshot shows the common settings for Active Directory.


Make sure you have your AD Domain Administrator credentials! You have to log in now with these credentials into TBG to have admin permissions.

  [email protected]