docs: matrix serverName defaults to bare domain, not subdomain (follow-up to #661)

This commit is contained in:
lexis 2026-05-30 23:28:52 +02:00 committed by Mara
commit bee338cf4f
2 changed files with 11 additions and 6 deletions

View file

@ -110,8 +110,13 @@ homeserver in a nixos-container. Requires either
`services.hyperhive.domain` or `services.hyperhive.matrix.serverName`
to be set (eval fails with a clear error if both are absent). The
`server_name` (embedded irrevocably in every user and room ID)
defaults to `matrix.<domain>`; override with
`services.hyperhive.matrix.serverName = "chat.example.com";` if needed. State
defaults to `<domain>` (bare hive domain, since #660); the hive-gateway serves
`.well-known/matrix/{client,server}` endpoints so clients auto-discover the
homeserver without a subdomain. **Existing homeservers** must set
`services.hyperhive.matrix.serverName = "matrix.<domain>";` explicitly to
preserve pre-#660 user/room IDs. Override with
`services.hyperhive.matrix.serverName = "chat.example.com";` for a custom
server name. State
lives at `/var/lib/nixos-containers/hive-matrix/`. Federation is
enabled with an empty `trusted_servers` list; e2ee is deferred to
a follow-up (#551).