Mantis Bug Tracker (commonly referred to as MantisBT) is a free web-based bug tracking system. Mantis offers many of the same capabilities as other trackers like Bugzilla, but is simpler and easy to set up.
Before beginning this guide, we assume that you've completed the getting started guide. If you are new to Linux server administration, we recommend considering the beginner's guide and the article concerning systems administration basics. Additionally, you'll need to have followed the LAMP guide for CentOS 5 and be able to send email from your Linode if you don't already have a means of sending mail from your server.
Before we begin installing Mantis, we'll need to install PHPMailer, an additional PHP library that allows Mantis to send email via PHP. The PHPMailer packages are not available in the standard CentOS repositories. As a result, "EPEL" must be installed in order to install PHPMailer. EPEL, or "Extra Packages for Enterprise Linux", is a product of the Fedora Project that attempts to provide current versions of software packages that may not be available in the CentOS repositories. Enable EPEL with the following commands:
rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm yum update
Once the EPEL repository has been added install PHPMailer by running:
yum install php-PHPMailer
Before restarting Apache, modify your php.ini file to match MantisBT's upload file size. Find the following line in your php.ini file and tweak it to match the example below:
; Maximum allowed size for uploaded files. upload_max_filesize = 5M
Afterwards, restart Apache by running the following command:
service httpd restart
For this installation, we'll assume you're installing Mantis to a directory under your document root (in this example the directory is named Mantis). To begin, we'll change into the site directory, download the latest MantisBT package, and unpack it. When running the following commands, be sure to download the latest release. You can find the latest version of MantisBT on the SourceForge page for MantisBT. Additionally, replace bucknell.net with the name of your site:
cd /srv/www/bucknell.net/ wget http://downloads.sourceforge.net/project/mantisbt/mantis-stable/1.2.4/mantisbt-1.2.4.tar.gz tar xvzf mantisbt-1.2.4.tar.gz
Next, we'll move the mantisbt-1.2.4 directory to our public_html directory under the name mantis. Additionally, we'll give Apache ownership in order to create the needed configuration files:
mv mantisbt-1.2.4/ /srv/www/bucknell.net/public_html/mantis chown -R apache:apache /srv/www/bucknell.net/public_html/mantis/
Visit the location of MantisBT in your browser. In our first example, the URL would be http://bucknell.net/mantis. Follow the installation instructions by providing the credentials to the MySQL database you created in the LAMP guide, or especially for Mantis. For additional MySQL help, see our MySQL guide. At this point Mantis is installed and ready to configure.
After the installation completes, you will be redirected to the login page. The default account credentials are administrator/root. Immediately log in and create another administrative account, and delete the default administrator account. You can manage users in the "Manage" section of the MantisBT interface.
Next, we'll set the timezone in config_inc.php. You can find a list of supported timezones at the List of Supported Timezones in the PHP Manual page. You'll need to add the $g_default_timezone line yourself. This section of the files should look similar to the following:
<?php $g_hostname = 'localhost'; $g_db_type = 'mysql'; $g_database_name = 'mantis'; $g_db_username = 'mantisuser'; $g_db_password = 'p@$$w0rd'; # You can add this at the end of the file $g_default_timezone = 'America/New_York'; ?>
Ensure that you have no whitespace at the end of this file, or Mantis will throw an error. Save and close the file. Finally, make sure to remove the admin folder under your MantisBT installation. In our example, the command would look like the following command. Note: Make sure to double-check your syntax when using the rm -rf command:
rm -rf /srv/www/bucknell.net/public_html/mantis/admin/
At this point, MantisBT is ready to use for your development project! For specific Mantis help and instruction, see the administration guide available on the MantisBT website. You can also install a number of plugins that allow you to customize MantisBT to your needs. Each of these plugins has a specific set of instructions that come with it. You can read more about these on the plugins section of the MantisBT site, listed below.
When running software compiled or installed directly from sources provided by upstream developers, you are responsible for monitoring updates, bug fixes, and security issues. After becoming aware of releases and potential issues, update your software to resolve flaws and prevent possible system compromise. Monitoring releases and maintaining up to date versions of all software is crucial for the security and integrity of a system.
Please monitor the Mantis project blog, development list, and announcement list to ensure that you are aware of all updates to the software and can upgrade appropriately or apply patches and recompile as needed:
When upstream sources offer new releases, repeat the instructions for installing the Mantis software as needed. These practices are crucial for the ongoing security and functioning of your system.
You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.
This guide is licensed under a Creative Commons Attribution-NoDerivs 3.0 United States License.
Last edited by System on Friday, April 29th, 2011 (r1585).