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: M4TR1X page is reached via swarm-ui's LinksMenu, not opened directly

Browse source 
mara (PR#3820): the operator doesn't type /matrix/ into the browser — it's a swarm-level link (hive-matrix.nix registers it into services.hyperhive.swarm.controller.links, rendered by swarm-ui's LinksMenu). Corrected the M4TR1X page doc, and fixed the hive-matrix.nix comment that still described the removed H0M3 tile in present tense while I was in there.
This commit is contained in:
iris 2026-08-31 12:51:47 +02:00
commit 19ed400cdd
2 changed files with 16 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

13
docs/web-ui/dashboard.md
View file

@ -636,9 +636,16 @@ nginx container at `/matrix/` when
`HIVE_MATRIX_GUI_ENABLED` env var → `state.matrix_gui_enabled` in
`/api/state`; the gateway does the actual static serving.
The operator opens `/matrix/` directly — there's no tile for it on the
H0M3 hub — logs in once with the in-host tuwunel homeserver URL
(`http://localhost:8008` or whatever the matrix module exposes).
There's no tile for it on the H0M3 hub (removed along with Forge's —
see the H0M3 section above). Instead the operator reaches it from the
swarm-ui LinksMenu (the 🔗 popover on every swarm-ui route,
`docs/swarm/ui.md::Quick links`) — `hive-matrix.nix` registers a
`{label: "Matrix", url: "https://<gatewayHost>/"}` entry into
`services.hyperhive.swarm.controller.links` whenever the gateway
fronts matrix and the GUI is on, same gating condition
`state.matrix_gui_enabled` used to check. Logs in once with the
in-host tuwunel homeserver URL (`http://localhost:8008` or whatever
the matrix module exposes).
The unified nginx-front re-root to
`https://chat.${hyperhive.swarm.domain}` + `.well-known/matrix/client`

10
nix/host-modules/hive-matrix.nix
View file

@ -513,10 +513,12 @@ in
# This swarm-ui quick-links entry. Gated on `gui.enable` too, not just
# `gatewayHost != null`: `/` on that vhost only serves fluffychat
# (below) when the GUI is on — otherwise the link would 404, the same
# reason the old dashboard's H0M3 page hides its Matrix tile on
# `state.matrix_gui_enabled` rather than `gatewayHost` alone. See
# `services.hyperhive.swarm.controller.links`'s description.
# (below) when the GUI is on — otherwise the link would 404. Same
# `gatewayHost && gui.enable` condition the removed hive-dashboard
# H0M3 tile used to check via `state.matrix_gui_enabled` before this
# link became the only way in (docs/web-ui/dashboard.md::M4TR1X
# page). See `services.hyperhive.swarm.controller.links`'s
# description.
services.hyperhive.swarm.controller.links =
lib.optional (cfg.gatewayHost != null && cfg.gui.enable)
{