From 2102b309de0768b3b6db4677d39b26a54ebcf1e4 Mon Sep 17 00:00:00 2001 From: William Mantly Date: Tue, 21 Jul 2026 00:58:27 -0400 Subject: [PATCH] docs: Document load balancing feature --- README.md | 1 + docs/concepts-hosts.md | 4 ++++ docs/index.md | 1 + 3 files changed, 6 insertions(+) diff --git a/README.md b/README.md index aebb6e4..3cf717c 100755 --- a/README.md +++ b/README.md @@ -51,6 +51,7 @@ provider + LDAP directory you already run. - Multiple DNS provider integrations (Cloudflare, DigitalOcean, PorkBun, DuckDNS — DuckDNS is free) - Wildcard SSL certificate support with automatic renewal - Dynamic host routing with wildcard domain matching (*, **) +- **Multi-target load balancing** — configure multiple backend targets per host with built-in round-robin load balancing - Web-based management interface - RESTful API for automation - **OIDC login** — the proxy is an OpenID Connect client of an external SSO diff --git a/docs/concepts-hosts.md b/docs/concepts-hosts.md index 806bd53..504d2e1 100644 --- a/docs/concepts-hosts.md +++ b/docs/concepts-hosts.md @@ -68,6 +68,10 @@ host form whenever the name you're entering already has a matching wildcard available to reuse — including the wildcard's own bare base domain (e.g. `example.com` itself, not just `something.example.com`). +## Load Balancing + +If you have multiple servers running the same application, you can load balance traffic across them. When editing a host, you can specify **Additional Targets** (one `IP:port` per line). The proxy will automatically distribute incoming requests across your primary target and all additional targets using a round-robin strategy, providing simple high availability and load distribution without extra configuration. + ## Want more detail? This page skips the system-internals (Redis, OpenResty, the lookup service) diff --git a/docs/index.md b/docs/index.md index c892268..1178b61 100644 --- a/docs/index.md +++ b/docs/index.md @@ -50,6 +50,7 @@ LDAP directory you already run. - Automated HTTPS via Let's Encrypt — HTTP-01 and DNS-01 (wildcard) challenges - Multiple DNS providers (Cloudflare, DigitalOcean, PorkBun, DuckDNS — free) - Dynamic host routing with wildcard domain matching (`*`, `**`) +- **Multi-target load balancing** — configure multiple backend targets per host with built-in round-robin load balancing - **OIDC login** and **direct LDAP lookups**, independently of each other - Per-host **basic auth** as an alternative to SSO (mutually exclusive, so it's never ambiguous which one gated a request)