"vault backup: 2026-03-08 14:11:41 from Flow"

21-Server Reference/homelab/stacks/matrix.md

@@ -144,7 +144,23 @@ volumes:
 | `/home/artanis/DockerFiles/Matrix/slackdata` | Slack bridge config/state |
 | `/home/artanis/DockerFiles/Matrix/discorddata` | Discord bridge config/state |
 
+## Matrix Relay
+
+`matrix-relay` is a small custom Python/Flask app. Its purpose is to receive Matrix push notifications and forward them to Home Assistant via webhook.
+
+- **Source:** `/home/artanis/DockerFiles/Matrix/matrix_relay.py`
+- **Dockerfile:** `/home/artanis/DockerFiles/Matrix/matrix_relay.Dockerfile`
+- **Listens on:** port `5101` (internal only)
+- **Forwards to:** `https://homeassistant.bunny-wyvern.ts.net/api/webhook/artanis_matrix_push`
+- **Stack rebuild docs:** check `/home/artanis/DockerFiles/Matrix/` for any additional docs
+
+To rebuild the image after source changes:
+```bash
+cd /home/artanis/DockerFiles/Matrix/matrix
+docker compose build matrix-relay
+docker compose up -d matrix-relay
+```
+
 ## Notes
-- The `matrix-relay` container is built from a local `matrix_relay.Dockerfile` located one directory up from the compose file (`/home/artanis/DockerFiles/Matrix/`)
 - Synapse does not expose any ports to the host — it is only reachable via the `matrix_matrix-internal` network and through Tailscale
 - The Tailscale sidecar attaches to `synapse`'s network namespace, so Synapse's internal ports (8008, 8448) become accessible at `matrix.bunny-wyvern.ts.net`