How to Install MantisBT on FreeBSD Latest

MantisBT is an open-source issue tracking system that is used to track bugs and issues within the software development process. It is a popular tool among developers and project managers. In this tutorial, we will go through the steps required to install MantisBT on FreeBSD latest release.

Prerequisites

Before we begin, please make sure that you have the following installed on your FreeBSD system:

  • sudo access
  • Apache web server
  • PHP version 7 or above
  • MySQL or MariaDB

Step 1: Create a Database for MantisBT

We need to create a database to store the data for the MantisBT application. We will assume that you already have a MySQL or MariaDB server installed.

  1. Login to the MySQL or MariaDB server using the command line tool.

sudo mysql -u root -p

  1. Create a new database for MantisBT. Replace mantis_db with your preferred database name.

create database mantis_db;

  1. Create a new user and grant the necessary privileges.

CREATE USER 'mantis_user'@'localhost' IDENTIFIED BY 'your-password';

GRANT ALL PRIVILEGES ON mantis_db.* TO 'mantis_user'@'localhost';

  1. Flush the privileges to apply the changes.

FLUSH PRIVILEGES;

Exit the MySQL or MariaDB server interface.

Step 2: Download the MantisBT Package

  1. Download the latest version of MantisBT from the official website:

wget https://downloads.sourceforge.net/project/mantisbt/mantis-stable/2.24.3/mantisbt-2.24.3.tar.gz

  1. Extract the file to the /usr/local/www directory:

sudo tar zxvf mantisbt-2.24.3.tar.gz -C /usr/local/www

  1. Rename the extracted folder to mantisbt:

sudo mv /usr/local/www/mantisbt-2.24.3 /usr/local/www/mantisbt

  1. Change the ownership of the mantisbt directory to the Apache web server:

sudo chown -R www:www /usr/local/www/mantisbt

Step 3: Configure Apache with PHP

  1. Open the Apache configuration file using your preferred text editor:

sudo nano /usr/local/etc/apache24/httpd.conf

  1. Uncomment the following lines:
LoadModule php7_module        libexec/apache24/libphp7.so
AddHandler php7-script        php

  1. Save and exit the file.

  2. Restart the Apache web server for the changes to take effect:

sudo service apache24 restart

Step 4: Install MantisBT

  1. Navigate to the MantisBT directory:

cd /usr/local/www/mantisbt

  1. Rename the config_inc.php.sample file to config_inc.php:

sudo mv config/config_inc.php.sample config/config_inc.php

  1. Edit config_inc.php to set the database parameters:

sudo nano config/config_inc.php

  1. Find the following lines and update them with your database credentials:
$g_hostname      = 'localhost';
$g_db_username   = 'mantis_user';
$g_db_password   = 'your-password';
$g_database_name = 'mantis_db';

  1. Save and exit the file.

  2. Change the ownership of the config_inc.php file:

sudo chown www:www config/config_inc.php

  1. Open your web browser and navigate to http://localhost/mantisbt/admin/install.php.

  2. Follow the instructions on the screen to complete the installation process.

  3. Once the installation is complete, delete the install.php file for security reasons:

sudo rm /usr/local/www/mantisbt/admin/install.php

Congratulations! You have successfully installed MantisBT on FreeBSD latest release. You can now use it to track bugs and issues in your software development process.