{"id":7383,"date":"2020-12-14T19:34:26","date_gmt":"2020-12-14T16:34:26","guid":{"rendered":"https:\/\/kifarunix.com\/?p=7383"},"modified":"2024-03-15T09:06:14","modified_gmt":"2024-03-15T06:06:14","slug":"install-mantis-bug-tracker-on-debian","status":"publish","type":"post","link":"https:\/\/kifarunix.com\/install-mantis-bug-tracker-on-debian\/","title":{"rendered":"Install Mantis Bug Tracker on Debian 10"},"content":{"rendered":"
\n
\"Install<\/figure><\/div>\n\n\n

Welcome to our tutorial on how to installing Mantis Bug Tracker. Mantis Bug Tracker (MantisBT)<\/a>, is a popular free web-based\u00a0bug tracking system. It is written in PHP and supports to multiple database backends including MySQL, MS SQL and PostgreSQL.<\/p>\n\n\n\n

Installing Mantis Bug Tracker on Debian 10<\/h2>\n\n\n\n

MantisBT is PHP based and supports a variety of database backends as mentioned above. In this guide, however, we will install Mantis bug tracker with MariaDB as the database backend. This therefore means that you need to a LAMP stack up and running for you to run Mantis bug tracker on Debian 10.<\/p>\n\n\n\n

Install LAMP Stack on Debian 10<\/h3>\n\n\n\n

As already mentioned above, in this guide, we will setup MantisBT to use MySQL 8 database backend. As such, begin by installing LAMP stack on Debian 10.<\/p>\n\n\n\n

We have already covered the installation of LAMP Stack on Debian 10 in a separate tutorial whose link is provided below;<\/p>\n\n\n\n

Install LAMP Stack on Debian 10<\/a><\/p>\n\n\n\n

The guide reference above uses PHP 7.3. However, if you need to install PHP 7.4, add SURY PPA repos and proceed as follows;<\/p>\n\n\n\n

apt -y install lsb-release apt-transport-https ca-certificates wget<\/code><\/pre>\n\n\n\n
wget -O \/etc\/apt\/trusted.gpg.d\/php.gpg https:\/\/packages.sury.org\/php\/apt.gpg<\/code><\/pre>\n\n\n\n
echo \"deb https:\/\/packages.sury.org\/php\/ $(lsb_release -sc) main\" | sudo tee \/etc\/apt\/sources.list.d\/php.list<\/code><\/pre>\n\n\n\n
apt update<\/code><\/pre>\n\n\n\n
Next, install PHP 7.4 and other other PHP extensions and other packages;<\/p>\n\n\n\n
apt install php libapache2-mod-php php-{mysql,date,json,mbstring,curl,gd,ldap,intl,xml,zip,bcmath,pear} libpcre3 libpcre3-dev zip<\/code><\/pre>\n\n\n\n
Create MantisBT Database and Database User<\/h3>\n\n\n\n
 Login to MySQL and create MantisBT database and database user. Be sure to replace the names of the database, database user and the password.<\/p>\n\n\n\n
mysql<\/code><\/pre>\n\n\n\n
If you have enabled password authentication;<\/p>\n\n\n\n
mysql -u root -p<\/code><\/pre>\n\n\n\n
Then create database and database user;<\/p>\n\n\n\n
create database mantisbt;<\/code><\/pre>\n\n\n\n
create user mantisadmin@localhost identified by 'changeme';<\/code><\/pre>\n\n\n\n
grant all on mantisbt.* to mantisadmin@localhost;<\/code><\/pre>\n\n\n\n
Reload privileges tables and exit the database connection.<\/p>\n\n\n\n
flush privileges;\nquit<\/code><\/pre>\n\n\n\n
Restart MariaDB database service.<\/p>\n\n\n\n
systemctl restart mariadb<\/code><\/pre>\n\n\n\n
Installing Mantis Bug Tracker <\/h3>\n\n\n\n
Download MantisBT archive<\/h4>\n\n\n\n
Download the latest stable MantisBT release from the downloads<\/a> page.<\/p>\n\n\n\n
You can simply obtain the url and pull it using wget. For example, to download the current stable release (v2.24.3) as of this writing, simply run the command below;<\/p>\n\n\n\n
wget https:\/\/tenet.dl.sourceforge.net\/project\/mantisbt\/mantis-stable\/2.24.3\/mantisbt-2.24.3.zip<\/code><\/pre>\n\n\n\n
Extract MantisBT Archive<\/h4>\n\n\n\n
Extract MantisBT and move it to your default web root directory.<\/p>\n\n\n\n
unzip mantisbt-2.24.3.zip<\/code><\/pre>\n\n\n\n
mv mantisbt-2.24.3 \/var\/www\/html\/mantisbt<\/code><\/pre>\n\n\n\n
Create Apache MantisBT Site Configuration<\/h4>\n\n\n\n
Next, create Apache MantisBT site configuration.<\/p>\n\n\n\n
vim \/etc\/apache2\/sites-available\/mantisbt.conf<\/code><\/pre>\n\n\n\n
<VirtualHost *:80>\n    DocumentRoot \"\/var\/www\/html\/mantisbt\"\n\n    ServerName mantisbt.kifarunix-demo.com\n\n    ErrorLog \"\/var\/log\/apache2\/mantisbt_error_log\"\n    CustomLog \"\/var\/log\/apache2\/mantisbt_access_log\" combined\n\n        <Directory \"\/var\/www\/html\/mantisbt\/\">\n            DirectoryIndex index.php \n            Options -Indexes +FollowSymLinks\n            AllowOverride All\n            Require all granted\n        <\/Directory>\n\n<\/VirtualHost><\/code><\/pre>\n\n\n\n
Save and exit the configuration file. Be sure to set the proper settings as per your setup.<\/p>\n\n\n\n
Check Apache Syntax configuration;<\/p>\n\n\n\n
apachectl -t<\/code><\/pre>\n\n\n\n
Disable the default Apache site;<\/p>\n\n\n\n
a2dissite 000-default.conf<\/code><\/pre>\n\n\n\n
Enable MantisBT site;<\/p>\n\n\n\n
a2ensite mantisbt.conf<\/code><\/pre>\n\n\n\n
Change the ownership of the MantisBT web root directory;<\/p>\n\n\n\n
chown -R www-data: \/var\/www\/html\/mantisbt<\/code><\/pre>\n\n\n\n
Restart Apache;<\/p>\n\n\n\n
systemctl restart apache2<\/code><\/pre>\n\n\n\n
Accessing MantisBT Web Interface<\/h4>\n\n\n\n
To allow external access, you need to open port 80\/tcp on UFW if it is running (ufw is).<\/p>\n\n\n\n
ufw allow Apache<\/code><\/pre>\n\n\n\n
Now access MantisBT using the URL http:\/\/server-IP-or-domain<\/code><\/strong>.<\/p>\n\n\n\n
Go through the Pre-Installation Check and ensure everything is good.<\/p>\n\n\n\n
\"Install<\/figure>\n\n\n\n
Configure MantisBT database connections;<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Click Install\/Upgrade Database<\/strong><\/code> button to install setup MantisBT DB.<\/p>\n\n\n\n
Once the installation completes, you should see such an interface.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Rename the admin directory and click Continue<\/strong> to proceed to the login page.<\/p>\n\n\n\n
mv \/var\/www\/html\/mantisbt\/admin{,-old}<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
The default login credentials are:<\/p>\n\n\n\n