From 19ed400cddf1d92a96be8b8e58622f15b4d469fd Mon Sep 17 00:00:00 2001 From: iris Date: Mon, 31 Aug 2026 12:51:47 +0200 Subject: [PATCH] docs: M4TR1X page is reached via swarm-ui's LinksMenu, not opened directly MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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. --- docs/web-ui/dashboard.md | 13 ++++++++++--- nix/host-modules/hive-matrix.nix | 10 ++++++---- 2 files changed, 16 insertions(+), 7 deletions(-) diff --git a/docs/web-ui/dashboard.md b/docs/web-ui/dashboard.md index 04b1f2ca..c78b62f9 100644 --- a/docs/web-ui/dashboard.md +++ b/docs/web-ui/dashboard.md @@ -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:///"}` 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` diff --git a/nix/host-modules/hive-matrix.nix b/nix/host-modules/hive-matrix.nix index 632643a7..bc836acc 100644 --- a/nix/host-modules/hive-matrix.nix +++ b/nix/host-modules/hive-matrix.nix @@ -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) {