docs: add Caddy reverse-proxy example + proxy guide#7
Open
shanzez wants to merge 1 commit into
Open
Conversation
Add examples/Caddyfile (automatic HTTPS + transparent WebSocket support) and guides/reverse-proxy.md covering nginx, Caddy, and Traefik, with the key gotchas: forwarding WebSockets for the transactor, and keeping SECURE + HOST_ADDRESS consistent so Huly emits https/wss. Link the guide from README. Addresses the recurring 'how to use Caddy' request (upstream huly-selfhost#82). Caddyfile validated with 'caddy validate'. Signed-off-by: Exaviz <info@exaviz.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a Caddy option for fronting Huly (the repo already covers nginx + Traefik), plus a short guide tying the options together.
What
examples/Caddyfile- fronts Huly with automatic Let's Encrypt HTTPS and transparent WebSocket support. Because Caddy handles TLS renewal and WebSocket upgrades itself, the whole config is a few lines.guides/reverse-proxy.md- nginx / Caddy / Traefik, with the two gotchas that actually bite people: thefrontneeds WebSocket forwarding (the transactor), andSECURE+HOST_ADDRESSmust be set so Huly emitshttps/wss(a mismatch is the usual "Failed to fetch" / websocket-error cause).Mirrors the existing
.template.nginx.confproxy target and headers. Addresses the recurring "how to install with Caddy" request (upstream huly-selfhost#82).Testing
Caddyfilepassescaddy validate(adapter: caddyfile) - confirmed auto-HTTPS + HTTP->HTTPS redirect. Docs-only otherwise.Contributed by Exaviz (exaviz.com).