Mantræ Docs

Mantræ is a web interface for managing Traefik's dynamic configuration. It generates configuration files that Traefik consumes via its HTTP provider.

What Mantræ Does

Generates Traefik dynamic configuration (routers, services, middlewares)
Manages multiple configuration profiles for different environments
Provides optional agents for automatic Docker container discovery
Integrates with DNS providers (Cloudflare, PowerDNS, Technitium)
Backs up and restores configurations

Note

Mantræ is not a Traefik dashboard. It doesn't monitor Traefik's status. Instead, Traefik pulls configuration from Mantræ.

Prerequisites

Docker (recommended) or Go runtime
A running Traefik instance
OpenSSL or similar tool for secret generation

Installation

Generate a Secret

openssl rand -hex 16

Deploy Mantræ

Choose your deployment method:

Create a compose.yml file:

compose.yml

services:
  mantrae:
    image: ghcr.io/mizuchilabs/mantrae:latest
    container_name: mantrae
    environment:
      - SECRET=your-generated-secret
      - ADMIN_PASSWORD=your-admin-password
    ports:
      - "3000:3000"
    volumes:
      - ./mantrae:/data
    restart: unless-stopped

Run with:

docker compose up -d

docker run --name mantrae \
   -e SECRET=your-generated-secret \
   -e ADMIN_PASSWORD=your-admin-password \
   -p 3000:3000 \
   -v ./mantrae:/data \
   ghcr.io/mizuchilabs/mantrae:latest

Download from the releases page, then:

export SECRET=your-generated-secret
export ADMIN_PASSWORD=your-admin-password
./mantrae

Access the Interface

Open http://localhost:3000 and log in:

Username: admin
Password: your admin password

Configure Traefik

Point Traefik to Mantræ's HTTP provider endpoint. You'll need a profile token (found in profile settings).

traefik.yml

providers:
  http:
    endpoint: "http://mantrae:3000/api/default?token=PROFILE_TOKEN"
    pollInterval: "5s"

compose.yml

services:
  traefik:
    image: traefik:latest
    container_name: traefik
    command:
      - --providers.http.endpoint=http://mantrae:3000/api/default?token=PROFILE_TOKEN
      - --providers.http.pollInterval=5s
      - --entrypoints.web.address=:80
      - --entrypoints.websecure.address=:443
    ports:
      - "80:80"
      - "443:443"
    restart: unless-stopped

Replace PROFILE_TOKEN with your actual token from the profile settings.

Create Your First Router

Navigate to Routers in the Mantræ interface.
Click Add Router.
Configure the router:
- Name: whoami
- Rule: Host(`whoami.local`)
- Service: Create or select a service pointing to your backend.
Save.