Mantis Bug Tracker Tutorial: MantisBT Issue Tracker Complete Guide

MantisBT open source free popular bug tracking system tutorial:

Testing is an integral part of any software development life cycle. The software bug is an error in a software application which causes software to produce incorrect results. Therefore, causing deviation in the expected, and actual outcome.

A bug tracking software is a software application used to maintain records of software bugs reported during the software development life cycle.

What You Will Learn:

Mantis Bug Tracking Tool Tutorial

Why we need a Bug Tracking System?

Recommend read => Most Popular Bug Tracking Systems

To manage the issues logged during software development life cycle proper managing system is required. A bug tracking facilitates in managing bugs so that proper track record of the bugs could be maintained, and be accessible to the team members working towards the development of the project.

Basically, the Bug Tracker is a software application which is used to track record of the bugs produced during the development of a software.

Also read => Benefits of Defect Tracking System

Introduction to Mantis Bug Tracker

Mantis Bug Tracker is one such tool that can serve the purpose of Bug tracking. Mantis BugTracker or MantisBT got started developed by Kenzaburo Ito in the year 2000. Jeroen Latour, Julian Fitzell, and Victor Boctor joined in the year 2002 and it became a team project.

The version 1.0.0 of Mantis Software was released in the year 2006. Since then, new updates have been launched. In July 2012, the MantisBT organization on GitHub became the official repository for the Project’s source code. Currently, MantisBT 2.5.1 is the latest stable version available in the market.

Mantis software is developed in PHP language, and supports databases like MySQL, MS SQL, PostgreSQL, and numerous browsers, but not limited to Google Chrome, Mozilla Firefox, Internet Explorer, Safari, Opera. The UI of Mantis tool is built using HTML and CSS.

This is released under GNU General Public License (GPL).

Salient features of MantisBT

Following points have been covered in this article:

Following are the software packages which we require to install MantisBT:

To install PHP, MySQL, Web server altogether on Windows we can use WampServer.

Download and Install WampServer

Follow steps to download and install WampServer in windows:

Follow the wizard and install WampServer through following steps:

Check if wampserver installed:

How to check if wampserver installed successfully and all its services are working fine or not.

#1) The color of the icon of the wampserver at system tray should be green. Green color means all the services are running fine. If the color of the icon is orange that means, there is something wrong and services are not running

#2) To Check Apache Service Running or Not: Right click on the wampserver icon at system tray then go to tools and then click on the Test Port 80, as this is the port which is used by Apache server

After clicking on Test Port 80, a dos black screen will get open and it will give the result like this below black screen.

#3) To Check MySQL Service Running or Not: Right click on the wampserver icon at system tray then go to tools then click on the Test Port 3306, as this is the port which is used by MySQL

After clicking on that a DOS screen will get open and it will give the result like this below back screen.

How to install MantisBT in Windows?

Download and Install Mantis Bug Tracker:

Follow steps to download and install MantisBT

Note: I have installed WampServer in C drive. Use the path where WampServer is installed.

Note: By default port number 80 is selected, if that is occupied by some other process, you will need to change the port number. The Process to change the port number is explained later in this article.

Resolving errors:

During the installation process, you may find some errors. In this article, some of the common errors and their resolution have been listed out.

#1) VCRuntimeDll.140 error: When the following message is displayed during installation of wamp server: “The program can’t start because VCRUNTIME140.dll is missing from your computer. Try reinstalling the program to fix the problem.” then it implies “Visual C++ Redistributable Packages” are missing from your computer

Follow steps to resolve the error:

#2) Err_Connection_Refused: If the following page is displayed instead of the welcome page of WampServer, then use a different port number. As the current port number is being occupied by some other services

Follow steps to resolve the error:

User Interface of Mantis BugTracker

Once a user is logged in and set up the user profile, this is the first page which is displayed to the user.

Let us become familiar with the user interface, and understand the different features provided on the first screen of the Mantis Bug Tracker.

This page is divided into different sections. On the left side, there is Navigational menu having links to different pages.

1) Navigational Menu: This is the navigational menu having various links like Report issue, View issue

2) Assigned to me: In this section, all the issues which are assigned to the user who is logged in currently are displayed under this section.As you can have an idea the timing at which the bug was reported is displayed under bug summary, and a unique number is automatically assigned to each reported bug

3) Unassigned: In this section, all the issues which are pending to get assigned to the concerned person are displayed

4) Reported by me: All the issues reported by the user are displayed under this section

5) Recently Modified (30 days): All the issues, which have been modified during 30 days’ timeline is displayed under this section

6) Header: In header various links like Report issue, Invite users are provided. The user can directly click on Report Issue button and then can jump to report issues page. You can change the project for which you want to view issues or report an issue.

In the rightmost is the name of the logged in user is displayed. Click on which following options are displayed. The user can click on logout to exit the session.

7) Timeline: In this section, all the recent updates regarding the project are displayed. Whether the issue has been newly reported, closed or any updates made in an existing bug all activities of regarding the bug get logged in and displayed under this section.

How to report bugs in Mantis?

Recommended read => How to Write A Good Bug Report

 The First screen displayed to the user is the login page where the user is prompted to enter the login credentials

Reproducibility: It defines whether the bug reported is reproducible or not. The Mantis Bug Tracker provides default options under this category.

Following points are displayed in the drop down.

  1. Have not tried: Choose this option if you had not tried to reproduce the bug
  2. Always: Choose this option if the bug can be reproduced at every iteration
  3. Random: Choose this option if error occurring randomly
  4. Unable to reproduce: Choose this option if the scenario used had produced the unexpected result is not producing the bug anymore
  5. Sometimes: Choose this option if the bug occurs few times during iteration
  6. N/A

The following options are available under this category

  1. Feature
  2. Trivial
  3. Text
  4. Tweak
  5. Minor
  6. Major
  7. Crash
  8. Block

The following options are available under this category

  1. None
  2. Low
  3. Normal
  4. High
  5. Urgent
  6. Immediate

For example, in an e-commerce website, the products are not getting added to the cart. You can provide the short description for this as Shopping Cart. Products are not getting added to the cart.

Note that, a unique ID is assigned to the issue reported. This ID can be used to search the issue from the search bar.

If you want to view the reported issue, click on the ID as shown in the image. The reported issue will be displayed on the screen.

Thus, we have reported a bug in Mantis Bug tracker. Next, we will learn to create a project in MantisBT.

How to create a project in Mantis Bug Tracker?

Next, we will see how to create projects in mantis bug tracker. Mantis supports multiple projects in a single instance.

Follow steps to create a new project:

Note: Mantis provides different rights to the logged in user. So rights to Create the project are given to the administrator specific user only. So login with the user and following navigational menu is displayed.

By default following options are available:

  1. Development: Choose this option if the project is under development stage
  2. Release: Choose this option if the project is under release stage
  3. Stable: Choose this option if testing is carried out on the stable version of the project
  4. Obsolete: If the version of the project is out of date or not used currently than this option can be chosen
  5. View status: Select whether the project is private or public. As private projects, and progress in it is visible to only those users to whom this project is assigned
  6. Description: Under Description text box you can provide the description of the project
  7. And finally, click on Add Project button

A success message is displayed, and thus project gets added to the Mantis for bug reporting. Next, we will learn to create a user in MantisBT.

How to create a user in MantisBT?

We have seen how to create a project, and also have learned to report an issue in Mantis Bug Tracker. Basically, Rights to create a new user or edit an existing user are given to the person having administrator rights.

Create new account page facilitates administrator to manage users in the system. So login with the administrator. Once logged in with administrator following options as shown in the image will be displayed in the navigation menu.

Note: Username used for the new user must be unique, and shouldn’t be used previously.

Note: Real name used for the new user must be unique, and shouldn’t be used previously, the i.e real name of the new user should not coincide with the real name of an existing user.

  1. Viewer
  2. Reporter
  3. Updater
  4. Developer
  5. Manager
  6. Administrator

A new user thus gets created in the system.

How to configure Email in Mantis?

During software development, one of the biggest challenges is to keep the team notified about any changes, or bugs reported. MantisBT triggers an email notification to the concerned person if there is any new bug reported, or changes made in an existing bug.

Follow steps to configure email notification in MantisBT

$g_phpMailer_method = PHPMAILER_METHOD_SMTP;
$g_smtp_host = ‘';
$g_smtp_port = ‘465';
$g_smtp_connection_mode = ‘ssl';
$g_smtp_username = ‘';
$g_smtp_password = ‘xxxx';
$g_administrator_email = ‘';
$g_webmaster_email = ‘';
$g_from_email = ‘';
$g_return_path_email = ‘';
$g_default_timezone = ‘UTC';
$g_log_destination = ‘file:D:\mantisbt.log';

An email will get triggered to the concerned person.

How to use Filters in MantisBT?

When the number of bugs reported in project increases, it becomes very hectic to search for a specific group of the issue.

For example, In a project developer wants to resolve all the bugs which are assigned to him under high priority. In that case, filters can be applied to group the issues as per the requirement.

Let us understand how to apply filters to search or group the issues.

Save the Filter:

If you want to save the current filter, Click on Save filter button.

On the screen following options are displayed:

  1. Manage Filter: This option can be used to delete an existing saved filter
  2. Permalink: Permalink is used to create a link for a particular filter. That link can be shared with other team members, for that particular filter


Bug tracking software helps to manage the bug effectively, and efficiently. Ultimately, reducing time, and efforts in managing bug history. With proper management of bugs, we can improve the quality of the work process and can avoid any loopholes in the process for testing, and development.

With proper tracking, one can expect proper utilization of the resource (employee), and to deliver the maximum output from them. Thus, expecting a good Return on Investment.

Please share your comments or questions with us below.