Installation Overview

This guide covers the various methods for installing Mantis.

Deployment Options

Method	Best For	Complexity
Docker Compose	Development, small deployments	Low
Kubernetes	Production, large scale	Medium
Manual	Custom environments	High

Quick Start

For the fastest setup, use Docker Compose:

# Clone the repository
git clone https://github.com/MantisPlatform/mantis.git
cd mantis

# Copy environment template
cp .env.example .env

# Start core services (postgres, rabbitmq, mandible, thorax)
./docker.sh start
# To also start the Lens UI: ./docker.sh start-dev

System Requirements

Hardware

Component	Minimum	Recommended
CPU	2 cores	4+ cores
RAM	4 GB	8+ GB
Storage	20 GB	50+ GB SSD

Software

Dependency	Version
Docker	24.0+
Docker Compose	2.20+
PostgreSQL	16+
RabbitMQ	3.12+
Redis	7.0+

Architecture

(Thorax has no database — it reaches all persistence through Mandible over gRPC. Mandible owns PostgreSQL, the RabbitMQ topology, and Redis (for SSE session storage and JWT revocation); Thorax consumes commands from RabbitMQ and coordinates clustering via Redis.)

Next Steps

Requirements - Detailed requirements
Docker Compose - Recommended deployment method
Security Overview - Essential security configuration