MantisBT is a popular, open-source bug tracking system that provides a balance between simplicity and power. It is designed to help software development teams track code defects, manage feature requests, and communicate with users effectively. Because it is web-based and built on PHP, it is accessible from any browser and can be hosted on most standard web servers. This guide will walk you through everything you need to know to download, install, and configure your first project.
Understanding the Benefits of MantisBT
Before diving into the technical setup, it is helpful to understand why many teams choose this specific tool. MantisBT is known for its ease of use. Unlike some project management tools that require weeks of training, most users can learn to report and resolve issues in just a few minutes. It offers a clean interface and a robust set of features including email notifications, role-based access control, and a plugin system for extended functionality.
Another significant advantage is its cost. As open-source software, there are no licensing fees, making it an excellent choice for startups, non-profits, and individual developers. Despite being free, it is actively maintained by a global community, ensuring that security patches and new features are released regularly.
System Requirements for Installation
To run MantisBT successfully, your hosting environment or local server must meet several basic requirements. These are standard for most modern web applications, so you will likely find them pre-installed on most shared hosting plans.
- PHP: Version 7.0 or higher is recommended. Ensure that required extensions like mysqli or pdo_mysql are enabled.
- Database: You will need a database to store your issues and user data. MySQL or MariaDB are the most common choices, though PostgreSQL and Microsoft SQL Server are also supported.
- Web Server: Apache and Nginx are the most popular choices, but any server that supports PHP will work.
- Memory: While the application is lightweight, having at least 128MB of RAM dedicated to PHP is ideal for larger projects.
Step 1: Downloading the Software
The first step is to obtain the latest stable version of the software. You should always download the package from the official project website to ensure you have the most secure and up-to-date files. Look for the “Downloads” section and choose the compressed package format that suits your operating system, such as a .zip or .tar.gz file.
Once the download is complete, extract the files on your local computer. You will see a folder containing various subdirectories like api, core, and javascript. These files make up the core of the application and will need to be uploaded to your web server.
Step 2: Preparing the Server and Database
Before you can run the installation script, you must prepare a place for the data to live. Log in to your hosting control panel or use a command-line tool to create a new, empty database. For example, you might name it mantis_db.
Next, create a dedicated database user with a strong password. Grant this user all privileges for the new database. This step is crucial for security, as it ensures the application only has access to its own data and cannot interfere with other parts of your server. Keep these credentials handy, as you will need them in the next step.
Step 3: Uploading Files to Your Host
Using an FTP client like FileZilla or your hosting provider’s file manager, upload the extracted files to the desired directory on your server. If you want the bug tracker to be the main page of your site, upload the files to the public_html or www folder. If you want it to live at a specific address, such as yourdomain.com/bugs, create a folder named “bugs” and upload the files there.
Ensure that the web server has permission to read these files. On Linux servers, this usually means setting permissions to 755 for directories and 644 for files. The config directory may need temporary write permissions during the installation process.
Step 4: Running the Web-Based Installer
Once the files are uploaded, open your web browser and navigate to the URL where you placed the files. The system will automatically detect that it has not been installed yet and redirect you to the admin/install.php page. This page performs a system check to ensure your server meets all requirements.
You will see a series of status checks. If everything is green, proceed to the configuration section. Here, you will enter the database details you created earlier:
- Type of Database: Usually MySQL Improved.
- Hostname: Typically “localhost”.
- Database Name: The name you chose (e.g., mantis_db).
- Username: The database user you created.
- Password: The password for that user.
Click the “Install/Update Database” button. The system will create the necessary tables and set up the default configuration. If successful, you will see a message confirming the installation.
Step 5: Initial Configuration and Security
After the installation is complete, there are a few immediate steps you must take to secure your installation. First, log in using the default administrator account. The default username is administrator and the default password is root. Change this password immediately via the user management settings.
For security reasons, you must delete the admin folder from your server using your FTP client. Leaving this folder active can pose a security risk, as it contains scripts that could potentially be used to reset your database. The application will display a warning at the top of the page until this folder is removed.
Setting Up Your First Project
MantisBT organizes issues into projects. To create your first one, navigate to the “Manage” menu and select “Manage Projects.” Click the “Create New Project” button. You will be asked for a project name, status (such as development or release), and a description.
You can also choose between a “Public” or “Private” project. Public projects are visible to any registered user, while private projects are only visible to users you specifically add to the project. Once the project is created, you can define categories, such as “General,” “UI,” or “Backend,” to help organize incoming reports.
Best Practices for Reporting Issues
To get the most out of your new bug tracker, it is important to establish a clear workflow for your team. When reporting an issue, users should be encouraged to provide as much detail as possible. A good bug report typically includes a concise summary, a detailed description of the problem, and specific steps to reproduce the error.
MantisBT allows you to attach screenshots or log files to issues, which can be incredibly helpful for developers trying to diagnose a problem. Encourage your team to use the “Severity” and “Priority” fields correctly so that the most critical issues are addressed first.
Managing User Roles
MantisBT uses a hierarchical permission system. When adding users to your system, you can assign them different access levels:
- Viewer: Can see issues but cannot report or edit them.
- Reporter: Can report new issues and comment on them.
- Updater: Can update issue details and status.
- Developer: Full access to manage issues within assigned projects.
- Manager: Can manage project settings and users.
- Administrator: Full control over the entire system.
Extending Functionality with Plugins
One of the reasons for the longevity of MantisBT is its plugin architecture. If the core software does not have a feature you need, there is a good chance a plugin exists for it. Popular plugins include integration with version control systems like Git or SVN, advanced charting for analytics, and enhanced formatting for issue descriptions.
To install a plugin, you typically upload the plugin folder to the plugins directory on your server and then activate it through the “Manage Plugins” menu in the administration interface. Always ensure that the plugin you are installing is compatible with your current version of the software.
Finding Help and Documentation
If you encounter issues during setup or usage, there are several resources available. The official documentation provides a deep dive into every configuration option and administrative task. Additionally, the community forums are a great place to ask questions and share experiences with other users.
Many users also find value in the official bug tracker for the software itself. By browsing existing reports, you can see how the developers use the tool and find solutions to common configuration challenges. Regular backups of your database and configuration files are also recommended to ensure your data remains safe.
Conclusion
Setting up an efficient bug tracking system is a vital step for any development project. By following these steps, you have created a centralized hub for managing tasks and improving software quality. Remember to keep your installation updated and to periodically review your user permissions to maintain a secure environment. If you found this guide helpful, explore our other articles on software optimization and team productivity tools to further enhance your workflow.