Introduction

Welcome to the Mantis Administrator Guide. This documentation covers installation, configuration, security, and maintenance of the Mantis deployment automation platform.

What is Mantis?

Mantis is a deployment automation and remote execution system built in Rust with a modular architecture. It enables versioned command and script execution across distributed targets with full multi-tenant support.

Architecture Overview

Mantis consists of several components:

Component	Description
Lens	SvelteKit-based web management interface
Mandible	Axum REST API server for CRUD operations
Thorax	gRPC orchestration server for deployment execution
Tarsus	Client agent installed on deployment targets
Tegmina	Protected transport layer (WireGuard + WebSocket relay fallback)
Instinct	Shared core library with business logic

Who This Guide Is For

This guide is intended for:

System administrators installing and maintaining Mantis
Security engineers configuring authentication and encryption
DevOps engineers managing infrastructure and scaling
Platform engineers operating multi-tenant deployments

For API integration and development, see the Developer Guide.

Quick Start

Requirements - System prerequisites
Docker Compose - Fastest way to deploy
Security Overview - Essential security configuration
Production Checklist - Pre-production validation

Key Administrative Tasks

Task	Section
Install Mantis	Installation
Configure TLS/mTLS	Security
Set up users and roles	Access Control
Configure SSO	Identity Providers
Scale Thorax instances	Scaling
Set up monitoring	Monitoring
Configure backups	Backup & Recovery

Security First

Review the Production Checklist

Configure TLS certificates

Set up mTLS authentication

Enable encryption at rest

Configure proper RBAC

Need Help?

Check the Troubleshooting section
Review component logs via docker compose logs <service>
Verify health endpoints at /api/v1/health, /api/v1/health/live, /api/v1/health/ready