Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/fuomag9/caddy-proxy-manager/llms.txt

Use this file to discover all available pages before exploring further.

Caddy Proxy Manager gives you a powerful web interface for Caddy Server, eliminating manual configuration file editing. From reverse proxies and automatic HTTPS to a built-in Web Application Firewall and traffic analytics, everything is managed through a clean, responsive dashboard with a full REST API.

Quickstart

Deploy Caddy Proxy Manager with Docker Compose and set up your first proxy host in minutes.

Configuration

Explore all environment variables and Docker Compose profiles available for your deployment.

API Reference

Authenticate with Bearer tokens and interact with the full REST API at /api/v1/.

Security

WAF protection, geo blocking, mTLS with a built-in CA, and automatic HTTPS — all per host.

Core features

Reverse Proxy Hosts

Route HTTP/HTTPS traffic to any upstream with load balancing, health checks, and custom headers.

L4 TCP/UDP Proxying

Stream-proxy raw TCP and UDP traffic with TLS SNI matching and proxy protocol support.

Web Application Firewall

Block SQLi, XSS, LFI, and RCE attacks with Coraza and the OWASP Core Rule Set.

Geo Blocking

Allow or deny traffic by country, continent, ASN, CIDR, or exact IP per proxy host.

Certificates & mTLS

Automatic ACME certificates, DNS-01 challenge support, and a built-in CA for client certs.

Forward Auth Portal

Protect any proxied app with built-in identity management — no external IdP required.

Traffic Analytics

Live traffic charts, country maps, top user agents, and WAF event logs powered by ClickHouse.

Instance Sync

Push configuration from a master to one or more slave instances on every change.

Get started in three steps

1

Deploy with Docker Compose

Clone the repository, copy .env.example to .env, fill in your credentials, and run docker compose up -d. The dashboard is available at http://localhost:3000.
2

Create your first proxy host

Log in as admin, navigate to Proxy Hosts, and click Add Proxy Host. Enter your domain, upstream address, and enable SSL — Caddy obtains a Let’s Encrypt certificate automatically.
3

Secure and monitor

Enable the WAF, add geo blocking rules, and turn on ClickHouse analytics to gain full visibility into traffic and threats.
Caddy Proxy Manager requires Docker and Docker Compose. See the Quickstart for the full setup guide.

Build docs developers (and LLMs) love