Single-user control plane for Traefik
Desired state in SQLite → generated YAML → Traefik file provider
Features • Screenshots • Quick Start • Configuration • Documentation
| Module | Capabilities |
|---|---|
| Proxy Hosts | Multi-upstream WRR routing, optional Traefik health checks, forced HTTPS, ACME or custom certificates |
| SSL Management | ACME resolvers (HTTP-01 / DNS-01), PEM uploads, certificate expiry checker |
| Access Lists | IP allow/deny rules combined with BasicAuth |
| Redirects & Parked Hosts | Custom HTTP redirections and static parked pages |
| Headers & Lean WAF | Reusable header packs, IP/bot/path blocking rules, per-host rate limiting |
| TCP / UDP Streams | Configurable entry ports for raw TCP and UDP traffic |
| Operations | Access logs, audit logs, and one-click backup/restore |
See docs/FEATURES.md for the complete feature reference.
|
Sign in |
Dashboard |
|
Proxy hosts |
SSL & resolvers |
Deploy using the lean production branch (includes Compose, environment template, and data directories only, pulling the prebuilt GHCR image):
git clone -b production --single-branch --depth 1 \
https://github.com/ariadata/traefik-proxy-manager.git
cd traefik-proxy-manager
cp example.env .env
# Generate a secret key and set TPM_SECRETS_KEY in .env:
# openssl rand -hex 32
./init.sh
docker compose pull # ghcr.io/ariadata/traefik-proxy-manager:latest
docker compose up -dPanel: http://127.0.0.1:8080 (see DC_TPM_HTTP_PORT in .env).
git clone https://github.com/ariadata/traefik-proxy-manager.git
cd traefik-proxy-manager
cp example.env .env
make init && make compose-upCopy example.env → .env.
| Variable | Purpose |
|---|---|
TPM_SECRETS_KEY |
Encrypts DNS / BasicAuth secrets at rest |
DC_TPM_HTTP_PORT |
Panel bind (prefer 127.0.0.1:8080) |
TPM_INTERNAL_URL |
Traefik → TPM for parked pages (http://tpm:8080) |
TPM_IMAGE |
Control-plane image (default: GHCR latest) |
DC_TRAEFIK_STREAM_TCP / _UDP |
Host port range for streams |
Ops & security: docs/OPERATOR.md
make install
make run # API + panel on :8080
make dev-web # Vite HMR on :5173Requires Node.js 26.13.1 (see .nvmrc).
server/src/ Fastify API, SQLite, Traefik YAML render
web/ React admin panel
images/ Screenshots (+ thumbs/ for README)
configs/traefik/ Base + generated Traefik config
data/{tpm,traefik}/ DB, custom certs, acme.json
docs/ Product docs
.github/workflows/ GHCR publish
docker-compose.yml
| Doc | Description |
|---|---|
| FEATURES | Feature reference |
| ARCHITECTURE | System design |
| OPERATOR | Install, ops, security |
| SCHEMA | SQLite schema |
| ROADMAP | Planned work |
Use Backups in the panel, or:
./scripts/backup-sqlite.sh
./scripts/restore-sqlite.sh data/tpm/backups/tpm-….dbKeep TPM_SECRETS_KEY outside the archive.