Install Mantis Bug Tracker on Ubuntu 20.04

Last Updated:
Install Mantis Bug Tracker on Ubuntu 20.04

Welcome to our tutorial on how to install Mantis Bug Tracker on Ubuntu 20.04. Mantis Bug Tracker (MantisBT), is a popular free web-based bug tracking system. It is written in PHP and supports to multiple database backends including MySQL, MS SQL and PostgreSQL.

Installing Mantis BT on Ubuntu 20.04

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 MySQL 8 as the database backend. This therefore means that you need to a LAMP stack up and running for you to run Mantis bug tracker.

Install LAMP Stack on Ubuntu 20.04

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 Ubuntu 20.04.

We have already covered the installation of LAMP Stack on Ubuntu 20.04 in a separate tutorial whose link is provided below;

Install LAMP Stack on Ubuntu 20.04

Install other PHP extensions and other packages;

apt install php-{mysql,date,json,mbstring,curl,gd,fileinfo,ldap,cli,intl,xml,zip,bcmath,pear} libpcre3 libpcre3-dev zip

Create MantisBT Database and Database User

Login to MySQL and create MantisBT database and database user. Be sure to replace the names of the database, database user and the password.

create database mantisbt;
create user mantisadmin@localhost identified by 'changeme';
grant all on mantisbt.* to mantisadmin@localhost;

Note that the Database root account is required to setup MantisBT. By default, MySQL 8 root account uses auth_socket authentication plugin and it doesn’t have any password set. Hence, change the authentication plugin to the mysql native plugin and set the password for MySQL root account.

UPDATE mysql.user SET plugin = 'mysql_native_password' WHERE user = 'root' AND plugin = 'auth_socket';
ALTER USER root@localhost identified by 'changeme';

Reload privileges tables and exit the database connection.

flush privileges;

Restart MySQL database service.

systemctl restart mysql

Install Mantis BT

Download MantisBT archive

Download the latest stable MantisBT release from the downloads page.

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;


Extract MantisBT Archive

Extract MantisBT and move it to your default web root directory.

mv mantisbt-2.24.3 /var/www/html/mantisbt

Create Apache MantisBT Site Configuration

Next, create Apache MantisBT site configuration.

vim /etc/apache2/sites-available/mantisbt.conf
<VirtualHost *:80>
    DocumentRoot "/var/www/html/mantisbt"


    ErrorLog "/var/log/apache2/mantisbt_error_log"
    CustomLog "/var/log/apache2/mantisbt_access_log" combined

        <Directory "/var/www/html/mantisbt/">
            DirectoryIndex index.php 
            Options -Indexes +FollowSymLinks
            AllowOverride All
            Require all granted


Save and exit the configuration file. Be sure to set the proper settings as per your setup.

Check Apache Syntax configuration;

apachectl -t

Disable the default Apache site;

a2dissite 000-default.conf

Enable MantisBT site;

a2ensite mantisbt.conf

Change the ownership of the MantisBT web root directory;

chown -R www-data: /var/www/html/mantisbt

Restart Apache;

systemctl restart apache2

Accessing MantisBT Web Interface

To allow external access, you need to open port 80/tcp on UFW if it is running.

ufw allow Apache

Now access MantisBT using the URL http://server-IP-or-domain.

Go through the Pre-Installation Check and ensure everything is good.

precheck install

Configure MantisBT database connections;

mantisbt db

Click Install/Upgrade Database button to install setup MantisBT DB.

Once the installation completes, you should see such an interface.

mantisbt installation complete

Rename the admin directory and click Continue to proceed to the login page.

mv /var/www/html/mantisbt/admin{,-old}
mantisbt login

The default login credentials are:

  • Username: administrator
  • Password: root

Upon successful login, you land on MantisBT dashboard.

MantisBT dashboard

Reset your admin password.

MantisBT issues Dashboard.

Install Mantis Bug Tracker on Ubuntu 20.04

You can now continue to explore MantisBT.


MantisBT Administration Guide

Other Guides

Install Bugzilla Bug Tracker on Ubuntu 20.04

Install Bugzilla Bug Tracker on CentOS 8

Install and Setup LEMP Stack on Ubuntu 20.04


We're passionate about sharing our knowledge and experiences with you through our blog. If you appreciate our efforts, consider buying us a virtual coffee. Your support keeps us motivated and enables us to continually improve, ensuring that we can provide you with the best content possible. Thank you for being a coffee-fueled champion of our work!

Photo of author
Co-founder of, Linux Tips and Tutorials. Linux/Unix admin and author at

Leave a Comment