odysseus/docs
Léo f9235ebbf1
docs(setup): document the HTTP/2 reverse-proxy setup (#6046)
* docs(setup): document the HTTP/2 reverse-proxy setup

The "private or proxied deployments" section named Caddy, nginx and Traefik
but gave no runnable config, and never mentioned the main reason to bother:
the frontend is unbundled ES modules, so a page load is a few hundred small
same-origin requests. Over HTTP/1.1 the 6-connection cap serialises those
into dozens of round trips, which is invisible on localhost and dominates
load time over a LAN or VPN.

Adds a five-step setup you can paste: a Caddyfile for each of the three ways
people reach these boxes (public domain, Tailscale, own certificate), how to
run the proxy in the foreground and then as a service, the .env keys that
have to follow the origin, and a curl one-liner to confirm HTTP/2 actually
negotiated.

Also covers what bites when moving an existing install behind TLS:
SECURE_COOKIES applying regardless of the scheme the request arrived on,
OAUTH_REDIRECT_BASE_URL still defaulting to localhost because the MCP
redirect is registered up front rather than derived per request, and HSTS
being host-wide and port-agnostic. Notes that a custom HTTPS port does not
stop Caddy binding port 80 for the redirect, which is the failure I hit
first.

Docs only — no code change is needed to run behind HTTP/2 today.

* docs(setup): clarify HTTP/2 and origin migration

---------

Co-authored-by: Alexandre Teixeira <alexandremagteixeira@gmail.com>
2026-08-14 18:44:42 +01:00
..
agent-migration.md docs: add agent migration manifest helper (#3028) 2026-06-15 15:57:33 +09:00
attachments.md fix(stabilization): harden attachment lifecycle and agent guard signals (#5420) 2026-07-11 15:14:14 +01:00
backup-restore.md docs: add backup/restore guide for odysseus-backup (#2587) 2026-06-15 20:26:47 +09:00
bg.webm Odysseus v1.0 2026-05-31 23:58:26 +09:00
chat.webm Odysseus v1.0 2026-05-31 23:58:26 +09:00
compare.webm Odysseus v1.0 2026-05-31 23:58:26 +09:00
document.webm Odysseus v1.0 2026-05-31 23:58:26 +09:00
email-outlook.md docs(email): clarify Outlook password auth failures 2026-06-08 15:32:16 +01:00
gallery.webm Odysseus v1.0 2026-05-31 23:58:26 +09:00
index.html chore: update repository URLs after organization transfer (#5622) 2026-07-20 16:43:47 +02:00
notes.webm Odysseus v1.0 2026-05-31 23:58:26 +09:00
odysseus-browser.jpg Refresh README screenshot 2026-06-22 04:54:15 +00:00
odysseus-wordmark.png Refresh README presentation 2026-06-15 23:26:10 +09:00
odysseus.jpg Refresh README screenshot 2026-06-22 04:54:15 +00:00
pr-blocker-audit.md tools: add read-only PR blocker audit helper 2026-06-04 12:51:48 +01:00
research.webm Odysseus v1.0 2026-05-31 23:58:26 +09:00
security-ci.md ci: add CodeQL advanced setup to scan pull requests before merge (#5250) 2026-07-21 10:18:06 -07:00
setup.md docs(setup): document the HTTP/2 reverse-proxy setup (#6046) 2026-08-14 18:44:42 +01:00
theme.webm Odysseus v1.0 2026-05-31 23:58:26 +09:00