Installing Bugzilla [version 5.0.6]

Bugzilla is server software designed to help with the management of software development. To install it on our servers, please follow these steps:

Prerequisites:

1. Allow SSH access to your account and enable the Compiling tools option

Bugzilla needs to be installed through the command line with a compiler. You can allow SSH access to your account through the SSH Access section in your account's Control Panel as described in the SSH Access article. You will also need to enable the Compiling tools option on the same page.

2. Create a database and a database user for Bugzilla

Bugzilla needs a database to run. You need to create a database and a database user for your Bugzilla installation through the MySQL Databases section in your account's Control Panel. Instructions on how to create databases and database users are available in the Creating a MySQL database/user article. You can create a database through the Databases tab in this section. In this example, we are going to use a database called username_bugzilla:

You can create a database user through the MySQL users tab. In this example, we will use the bugzilladbuser username:

You will also need to associate the bugzilladbuser user with the username_bugzilla database, giving the user all privileges to manage the database, through the Privileges tab:

Installation and configuration:

1. Upload and extract the installation files

You can download the installation package from the Bugzilla website. You will then need to upload it to your account. The file needs to be uploaded to the directory you wish to install Bugzilla in. Instructions on how to upload files are available in the Uploading files section. Once the archive has been uploaded, you can extract it through the File Manager in the Control Panel of your account by clicking on the archive. In this example, we will extract the files to the /home/username/www/bugzilla directory.

2. Edit the configuration file

Navigate to the directory where the files were extracted and open the localconfig file for editing. In the File Manager in the account's Control Panel, you can open the file for editing by clicking on it. There, locate the following settings, and update their values:

$webservergroup = 'username';
$use_suexec = 1;
$db_driver = 'mysql';
$db_name = 'username_bugzilla';
$db_user = 'bugzilladbuser';
$db_pass = 'the_password_you_set_up';

These are the settings used in this example. For the $webservergroup setting, please use your hosting account's username. This is the same username that is automatically added as a prefix to your database name. The $use_suexec = 1; and $db_driver = 'mysql'; settings should be set as shown above. For the $db_name setting, please use the name of the database you created for Bugzilla earlier. For the $db_user and $db_pass settings, please use the username and password you created for Bugzilla earlier.

Note: MySQL 8 is not officially supported by the latest version of the Bugzilla software application.

3. Run the Bugzilla installation script

Log in to your account via SSH. Instructions on how to log in to your account via SSH are available in the SSH section. Navigate to your Bugzilla installation directory. You can navigate to the directory with the cd command:

cd /home/username/www/bugzilla

We will need to install the Perl modules required by Bugzilla. To do this, run the install-module.pl script in the installation directory as follows:

/usr/bin/perl install-module.pl --all

Finally, run the checksetup.pl script in the installation directory with the following command:

./checksetup.pl

During the script execution, you will be prompted to enter the administrator details for your Bugzilla installation. Please make sure you remember these details:

After the script finishes executing, you should get the checksetup.pl complete message.

4. Access your Bugzilla installation

Bugzilla should now be installed. You should be able to access the URL where you installed Bugzilla and see the default page there: