How to Install MantisBT on macOS

MantisBT is an open-source issue tracking system that allows developers to track bugs, feature requests, and other issues related to software development. In this tutorial, we will walk you through the process of installing MantisBT on macOS.

Prerequisites

Before installing MantisBT, make sure you have the following software installed on your macOS:

Step 1: Download MantisBT

Go to the official MantisBT website (https://www.mantisbt.org/download.php) and download the latest stable version of MantisBT. Extract the downloaded file to a folder in your system, for instance, /Applications/MAMP/htdocs/mantisbt/.

Step 2: Configure MySQL

You need to create a new MySQL database where MantisBT will store its data. Follow these steps to create a database:

  1. Open the MySQL command-line interface by running the following command:

    mysql -u root -p
    
  2. Enter your MySQL root password when prompted.

  3. Create a new database by running the following command:

    CREATE DATABASE mantisbt;
    
  4. Create a new MySQL user and grant it full privileges on the mantisbt database with the following command:

    GRANT ALL PRIVILEGES ON mantisbt.* TO 'mantisbtuser'@'localhost' IDENTIFIED BY 'password';
    

    Replace mantisbtuser and password with the username and password of your choice.

  5. Flush the MySQL privileges with the following command:

    FLUSH PRIVILEGES;
    

Step 3: Configure MantisBT

  1. Rename the config_inc.php.sample file located in the config folder to config_inc.php.

  2. Open the config_inc.php file in a text editor.

  3. Find the following lines and modify them:

    $g_hostname = 'localhost';
    $g_db_type = 'mysqli';
    $g_database_name = 'bugtracker';
    $g_db_username = 'root';
    $g_db_password = '';
    

    Update the values to the following:

    $g_hostname = 'localhost';
    $g_db_type = 'mysqli';
    $g_database_name = 'mantisbt';
    $g_db_username = 'mantisbtuser';
    $g_db_password = 'password';
    
  4. Save and close the config_inc.php file.

Step 4: Test MantisBT

  1. Start the Apache web server by running the following command in the terminal:

    sudo apachectl start
    
  2. Open a web browser and navigate to http://localhost/mantisbt.

  3. Follow the installation wizard to complete the installation process.

  4. After the installation is complete, you will be able to log in to MantisBT with the default administrator account:

    • Username: administrator
    • Password: root

Conclusion

In this tutorial, we showed you how to install MantisBT on macOS. We hope this guide has been helpful and that you can now use MantisBT to track bugs and issues in your software development projects.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!