2.2.2. Server Software Requirements

⁠2.2.2. Server Software Requirements

All of the required software is free for commercial and non-commercial use (open source). Please refer to the table in Section 2.2.2.1, “Versions compatibility table” for minimum and recommended versions.

Operating System
MantisBT runs on Windows, macOS, Linux, Solaris, the BSDs, and just about anything that supports the required server software.
Web Server
MantisBT is mainly tested with Microsoft IIS and Apache. However, it is expected to work with any recent web server software.
File Extensions: MantisBT uses only .php files. If your webserver is configured for other extensions (e.g. .PHP3, .PHTML) then you will have to request the administrator to add support for .PHP files. This should be a trivial modification. Further details can be found in the PHP documentation
PHP
The web server must support PHP. It can be installed as CGI or any other integration technology.
PHP extensions
MantisBT is designed to work in as many environments as possible. Hence the required extensions are minimal and many of them are optional affecting only one feature.
Mandatory extensions
The extension for the RDBMS being used ( mysqli with mysqlnd, pgsql, oci8, sqlsrv )
mbstring - Required for Unicode (UTF-8) support.
ctype, filter, hash, json, session, tokenizer - Required to run MantisBT in general. These are bundled with PHP, and enabled by default. Note that hash is a core extension since PHP 7.4.0, and json is a core extension since PHP 8.0.0.
Optional extensions
Curl - required for the Twitter integration feature
GD - required for the captcha feature
Fileinfo - required for file attachments and most of the plugins
Without this extension, file attachment previews and downloads do not work as MantisBT won't be able to send the Content-Type header to a browser requesting an attachment.
LDAP - required for LDAP or Active Directory authentication (see Section 8.2, “LDAP and Microsoft Active Directory”).
SOAP - required to use the SOAP API (see Section 5.38, “API”).
zlib - required to enable output compression (see Section 5.26, “Speed Optimisation”).
Note
You can check which PHP modules are installed by running php -m on the command line, or by using the php_info() function in a PHP script.
Database
MantisBT requires a database to store its data. The supported RDBMS are:
- MySQL (or one of its forks, e.g. MariaDB)
- PostgreSQL
Experimental support is also available for
- Microsoft SQL Server
- Oracle
Experimental support means that manual intervention by a skilled Database Administrator may be required to complete the installation, and/or that there may be known issues or limitations when using the software. Please refer to our Issue tracker, filtering on categories db mssql and db oracle to find out more about those.
Note
Please note that the MantisBT development team mainly works with MySQL, so testing for other drivers is not as extensive as we mainly rely on community contributions to improve support and fix issues with other RDBMS.
We therefore recommend MySQL to store your database.

⁠2.2.2.1. Versions compatibility table

Category	Package	Minimum Version	Recommended	Comments
RDBMS	MySQL	5.5.35	5.6 or later	PHP extension: mysqli with MySQL Native driver (mysqlnd)
	MariaDB	5.5.35	10.4 or later	PHP extension: mysqli
	PostgreSQL	9.2	11.20 or later	PHP extension: pgsql
	MS SQL Server	2012	2019 or later	PHP extension: sqlsrv
	Oracle	11gR2	19c or later	PHP extension: oci8
PHP	PHP	7.4	8.0 or later	See above for PHP extensions
Web Server	Apache	2.4.13	latest 2.4.x release
	lighttpd	1.4.x	1.4.x
	nginx	1.10.x	1.16.x or later
	IIS	7.5	10	Windows Server 2016 or later

Our minimum requirements are generally based on availability of support for the underlying software by their respective vendors. In some cases, we do require a specific version because we rely on a feature that is not available in older releases.

Warning

Running MantisBT with versions of the software components lower than the minimum requirements listed above is not supported.