MantisBT

small businessdeveloper tools

Lightweight PHP bug tracker with email integration, custom fields, time tracking, and a plugin system. One of the longest-standing open source issue trackers — simple to deploy and actively maintained after 20+ years

#bug-tracker#issues#project-management#php#self-hosted

Quick Start

docker run -d -p 8080:80 -e MANTIS_DB_HOST=db -e MANTIS_DB_NAME=mantis -e MANTIS_DB_USER=mantis -e MANTIS_DB_PASSWORD=secret vimagick/mantisbt

Overview

MantisBT is one of the oldest active open source bug trackers, first released in 2000 and still maintained today. It is a PHP application with a MySQL or PostgreSQL backend that handles issue creation, assignment, prioritisation, status tracking, and notification — the full lifecycle of a bug from report to resolution.

The email integration is the feature that separates MantisBT from simpler trackers. Issues can be submitted by email, and every status change and comment triggers a notification to relevant parties. Critically, users can reply to those notification emails and have their response recorded as a note on the issue. For teams managing external stakeholders or customers who would not naturally log into a web tracker, this creates a usable workflow without forcing a behaviour change.

Custom fields give you control over what information is collected per issue. Add a “browser version” field for a web product, a “customer name” dropdown for a support context, a “severity” scale that matches your internal process — these are defined in the admin panel without touching code. Issue categories, priorities, and resolutions are also configurable, so the system can be shaped to fit the team’s actual vocabulary.

The plugin ecosystem extends the core for more specific use cases. Time tracking, source control commit integration, advanced reporting, and email digest formats are all available through community plugins without forking the main codebase.

The honest limitation is visual age. MantisBT’s interface reflects its early-2000s origins and has not received a modern UI overhaul. For teams accustomed to Jira, Linear, or GitHub Issues, the aesthetics require adjustment. The functionality is solid; the experience is utilitarian.

MantisBT: Pros & Cons

Pros (The Wins)Cons (The Friction)
Email-driven:
Create and update issues
entirely by email.
Dated UI:
No significant visual
overhaul in years.
Custom fields:
Tailor the issue form
without code changes.
Not agile-native:
No sprint or kanban
views built in.
100+ plugins:
Time tracking, SCM links,
reporting, and more.
Basic compared to Jira:
Less feature depth for
large engineering teams.
20+ years maintained:
Stable, battle-tested,
still actively updated.
No mobile apps:
Functional but unpolished
mobile web experience.

Use Cases

Specific ways to use MantisBT for your workflow.

01
Track bugs and feature requests for a software project without paying for Jira or relying on a cloud-hosted issue tracker
02
Manage customer-reported issues in a self-hosted system where the client can submit and monitor tickets via email or a web form
03
Run a simple help desk where issues are routed by category to different team members with email notifications
04
Keep a project issue database with custom fields, priorities, and statuses that match your team's workflow

Deployment Strategy

Recommended ways to host MantisBT in your own environment.

docker
self-hosted