Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Features

Manage Caddy configuration, monitor your servers, and inspect logs from one interface. Your Caddyfile remains the source of truth.

Configure traffic

  • Caddyfile editor Edit with syntax highlighting, validate and format configurations, and restore saved versions.
  • Route manager Find routes across HTTP servers, edit upstreams, and keep notes alongside them. Routes without an explicit title display the first hostname’s leftmost DNS label in italics (for example, jellyfin.example.de becomes jellyfin). Clearing a custom title restores this default. Uptime labels use the same fallback; status history headings keep the full domain unless an explicit title exists. The fallback is display-only and does not change notes or the Caddyfile; wildcard, IP, placeholder and hostless routes stay untitled.
  • Configuration workflow Import or export a Caddyfile and reload Caddy from the UI.

See the editor, route manager, and Caddyfile guide.

Monitor health

  • Dashboard Check server status, upstream health, TLS state, and Caddy process information.
  • Metrics and uptime Follow traffic, latency, and upstream history; enable optional route checks.
  • Logs Tail live output, filter by severity or keyword, export logs, and configure access logging.
  • Notifications Receive alerts for health changes and expiring certificates through your chosen notification service, including self-hosted services on your network.

See metrics, logs, and integrations.

Manage certificates and instances

  • TLS certificates Inspect expiry dates, remove orphaned certificates, and download Caddy’s root CA.
  • Multiple instances Discover Docker containers or add local Caddy installations, then switch between them from the sidebar.

See certificates and the instance guide.

Adjust access and appearance

  • Authentication Protect the UI and API with persistent administrator credentials, cookie sessions and CSRF checks.
  • Themes Choose built-in dark and light palettes or provide a custom theme.
  • Navigation Bookmark pages and filtered views, with a responsive layout for smaller screens.

See authentication and custom themes.

Detailed capabilities

Expand either list for the complete feature reference, including configuration options and implementation details.

Full frontend feature list
  • Dashboard — Server and TLS status, HTTP server labels/listeners/route counts, upstream health, and Caddy version, uptime, memory and reload information
  • Caddyfile Editor — Caddyfile grammar highlighting, live validation, caddy fmt, site sorting, import/export, and version history with previews and rollback
  • Route Manager — Routes across HTTP servers, health and uptime, search, sortable/configurable columns, domain/upstream links, inline editing and notes
  • TLS Certificates — Certificate status and expiry, orphan cleanup, and root CA download with OS installation instructions
  • Logs — Live SSE streaming, keyword/severity filters, export, and access-log configuration
  • Metrics — Request counts, RPS, response times, status codes and p50/p95/p99 latency from Caddy’s Prometheus endpoint
  • Uptime — Upstream state, uptime and history sampled every 30 seconds. Optional route checks request sites through Caddy every 5 minutes (caddy-ui-route-check), detecting 5xx responses, timeouts and invalid TLS certificates; Caddy’s local CA is trusted automatically. Failures show their cause, and individual routes can be skipped. Route checks default to off because they add access-log entries and request metrics.
  • Notifications — ntfy, Discord, Slack, Pushover or custom webhooks for upstream/route state changes and expiring certificates or API tokens, with trigger controls and debounce. Route alerts require route checks. LAN/Docker destinations work; loopback and link-local addresses are blocked, and redirects are not followed.
  • Themes — 13 dark and 13 light palettes, independent dark/light selections, a first-run picker, and custom themes in THEMES_PATH. Preferences persist in settings.json.
  • Navigation — Browser history, bookmarks and filtered deep links (e.g. /routes?filter=srv0)
  • Authentication — Persistent administrator credentials, cookie sessions, CSRF protection and recovery keys
  • Multi-Instance — Discover Caddy containers, add/edit/remove instances, and switch servers from the sidebar
  • Mobile Friendly — Responsive layout with collapsible sidebar
Backend capabilities
  • Caddy admin API access (/config, /id, /load) and Caddyfile validation via /adapt
  • Caddyfile reads/writes, site sorting (public → internal → http), and route block updates
  • Formatting and version detection through docker exec in Docker mode (requires the socket mount)
  • Route discovery across HTTP servers, including nested upstreams
  • Upstream pool health checks with TCP fallback, plus persisted upstream/route history (7-day default retention)
  • Notification providers and trigger controls with configurable debounce
  • Certificate expiry checks, orphan/superseded/expired certificate cleanup, and root CA download
  • Caddyfile snapshots on save, live SSE logs, and access-log configuration
  • Persistent server labels, route notes and UI settings
  • Administrator cookie sessions, CSRF protection and scoped read-only integration tokens
  • Caddy process/HTTP metrics, metrics configuration, and optional public Prometheus scraping
  • Structured JSON logs (LOG_LEVEL) and status/uptime data for Homepage widgets