ProxyOS Documentation
ProxyOS is a self-hosted reverse proxy manager that runs Caddy and a Next.js dashboard together in a single container using s6-overlay. You create routes through the web UI; ProxyOS translates them into live Caddy configuration via the Caddy Admin API — no Caddyfile required.
Getting Started
| Installation | Docker Compose setup, prerequisites, .env file, first boot |
| Your First Route | Log in, expose a service, test with curl |
| Core Concepts | Routes, host types, TLS modes, trusted proxies |
| Docker Compose Reference | Every environment variable explained |
Features
Routes
- Creating Routes
- Upstream Configuration
- TLS Modes
- Health Checks
- Headers
- Load Balancing
- Rate Limiting
- WAF
- WebSockets
Host Types
Security & Access
Observability
Advanced
Deployment
- Behind Cloudflare Tunnel
- Trusted Proxies
- Behind Another Proxy
- Direct LAN
- Tailscale
- Multi-Host Federation
Troubleshooting
- Problem Index
- Not Authenticated / 401 after login
- Holding page shown instead of service
- Mixed content errors
- 502 Bad Gateway
- Cloudflared DNS errors after rebuild
- HTTPS upstream connection refused
- Upstream health check failed
- Routes not saving
- Container won't start
- Cookie not persisting
- Secret rotation logs everyone out
Admin
- Environment Variables
- Secrets Management
- Logging
- Database
- Backup and Restore
- Upgrades
- Security Hardening