vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

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

Browse source
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
Download patch file Download diff file Expand all files Collapse all files

8
CLAUDE.md
View file

@ -255,10 +255,10 @@ nix/
local-dev DNS; v0 HTTP-only (#609) local-dev DNS; v0 HTTP-only (#609)
modules/hive-matrix.nix optional in-container matrix-tuwunel modules/hive-matrix.nix optional in-container matrix-tuwunel
homeserver (`services.hyperhive.matrix.enable`, homeserver (`services.hyperhive.matrix.enable`,
default off); server_name derives from default off); server_name defaults to bare
`services.hyperhive.domain` (subdomain by default); `services.hyperhive.domain` (#660); gateway serves
federation on (empty trusted_servers), `.well-known/matrix/{client,server}` for
registration off, e2ee deferred (#551) auto-discovery; federation on, e2ee deferred (#551)
templates/harness-base.nix shared scaffolding for sub-agents + manager; templates/harness-base.nix shared scaffolding for sub-agents + manager;
`hyperhive.model` option (HIVE_DEFAULT_MODEL) `hyperhive.model` option (HIVE_DEFAULT_MODEL)
templates/agent-base.nix sub-agent nixosConfiguration templates/agent-base.nix sub-agent nixosConfiguration

9
README.md
View file

@ -110,8 +110,13 @@ homeserver in a nixos-container. Requires either
`services.hyperhive.domain` or `services.hyperhive.matrix.serverName` `services.hyperhive.domain` or `services.hyperhive.matrix.serverName`
to be set (eval fails with a clear error if both are absent). The to be set (eval fails with a clear error if both are absent). The
`server_name` (embedded irrevocably in every user and room ID) `server_name` (embedded irrevocably in every user and room ID)
defaults to `matrix.<domain>`; override with defaults to `<domain>` (bare hive domain, since #660); the hive-gateway serves
`services.hyperhive.matrix.serverName = "chat.example.com";` if needed. State `.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 lives at `/var/lib/nixos-containers/hive-matrix/`. Federation is
enabled with an empty `trusted_servers` list; e2ee is deferred to enabled with an empty `trusted_servers` list; e2ee is deferred to
a follow-up (#551). a follow-up (#551).