Skip to content

About

Self-hosted web UI & control plane for Traefik — manage proxy hosts, ACME SSL, access lists, lean WAF, and TCP/UDP streams via SQLite-to-YAML state.

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Traefik Proxy Manager

Traefik Proxy Manager

Single-user control plane for Traefik
Desired state in SQLite → generated YAML → Traefik file provider

GHCR License: MIT Node

Features • Screenshots • Quick Start • Configuration • Documentation


Features

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.

Screenshots

Sign in
Sign in
Dashboard
Dashboard
Proxy hosts
Proxy hosts
SSL
SSL & resolvers

Quick Start

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 -d

Panel: http://127.0.0.1:8080 (see DC_TPM_HTTP_PORT in .env).

Build from source (main)

git clone https://github.com/ariadata/traefik-proxy-manager.git
cd traefik-proxy-manager
cp example.env .env
make init && make compose-up

Configuration

Copy 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

Local development

make install
make run          # API + panel on :8080
make dev-web      # Vite HMR on :5173

Requires Node.js 26.13.1 (see .nvmrc).

Layout

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

Documentation

Doc Description
FEATURES Feature reference
ARCHITECTURE System design
OPERATOR Install, ops, security
SCHEMA SQLite schema
ROADMAP Planned work

Backup

Use Backups in the panel, or:

./scripts/backup-sqlite.sh
./scripts/restore-sqlite.sh data/tpm/backups/tpm-….db

Keep TPM_SECRETS_KEY outside the archive.

License

MIT © 2026 ariadata

About

Self-hosted web UI & control plane for Traefik — manage proxy hosts, ACME SSL, access lists, lean WAF, and TCP/UDP streams via SQLite-to-YAML state.

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages