Mantræ

Mantræ is a web-based configuration manager for Traefik's dynamic configuration file. It provides a clean, intuitive interface to manage your routers, middleware, and services without editing YAML or TOML files manually.

Important: Mantræ is not a dashboard for Traefik. It operates independently and does not monitor Traefik's status. Instead, Traefik connects to Mantræ to fetch its dynamic configuration.

Note: The Mantræ agent has moved to a separate repository: mantraed. The agent is now called mantraed (Mantræ daemon) and has its own container image at ghcr.io/mizuchilabs/mantraed. The old mantrae-agent image will remain available for compatibility but is deprecated.

Features

Clean Interface: Manage your Traefik configuration through a simple web UI
Router Management: Create and configure routers with custom rules, entrypoints, and middleware
Middleware Support: Add rate limiting, authentication, headers, and other middleware
Agent Mode: Label your containers with standard Traefik labels and let the agent automatically sync them
DNS Integration: Automatic DNS record management for Cloudflare, PowerDNS, Technitium and PiHole DNS

🚧 Development Status

This project is in active development and not yet production-ready. Expect breaking changes before the first stable release.

Quick Start

Installation

Using the install script:

curl -fsSL https://raw.githubusercontent.com/mizuchilabs/mantrae/main/install.sh | sh

Manual installation: Download the latest release from releases and extract to ~/.local/bin.

Docker (recommended for production): See the documentation for Docker setup instructions.

Usage

# Start the server
mantrae

# Display version
mantrae --version

# Reset admin password
mantrae reset --password newpassword

# Reset password for a specific user
mantrae reset --user username --password newpassword

Command Reference

| Command | Description | | ------------------- | -------------------------------------- | | mantrae | Start the Mantræ server | | mantrae reset | Reset user password (admin by default) | | mantrae --version | Display version information |

Flags

| Flag | Aliases | Default | Description | | ------------ | ------- | ------- | ------------------------------ | | --version | -v | | Display version and exit | | --password | -p | | New password (used with reset) | | --user | -u | admin | Username for password reset |

Documentation

Full documentation is available here

Screenshot

Dashboard

Contributing

Contributions are welcome! Feel free to submit issues, fork the repository, and create pull requests.

License

MIT License - See LICENSE

Acknowledgements

Traefik - The powerful reverse proxy that this project manages
Nginx Proxy Manager - Inspiration for the UI approach
External-DNS - Inspiration for DNS management

Mantrae

Install / Use

README