Skip to content

docs(alerts): add Matrix alerts page#121

Merged
dgibbs64 merged 1 commit into
masterfrom
docs/matrix-alerts
Jul 19, 2026
Merged

docs(alerts): add Matrix alerts page#121
dgibbs64 merged 1 commit into
masterfrom
docs/matrix-alerts

Conversation

@dgibbs64

Copy link
Copy Markdown
Member

Summary

Adds an alerts/matrix.md page documenting the Matrix alert provider added in GameServerManagers/LinuxGSM#4901 (which currently links to docs.linuxgsm.com/alerts/matrix, a 404 until this lands). Also adds it to the alerts nav in SUMMARY.md.

Content

Written against what was actually verified end-to-end while reviewing #4901:

  • Access token: where to find it in Element (Settings > Help & About > Advanced > Access Token).
  • Room ID vs space ID: must be the internal room ID (!...:server), not a room alias (#...) or a space ID — the space-vs-room mix-up is an easy trap and was hit during testing.
  • Encryption: LinuxGSM sends plain Client-Server API messages with no E2EE support, so alerts must go to an unencrypted room (encryption can't be disabled after room creation).
  • Homeserver delegation: note on .well-known delegation (matrix.org -> matrix-client.matrix.org) as a fallback if the bare domain fails.

Related

Documents the Matrix alert provider added in
GameServerManagers/LinuxGSM#4901. Covers getting an access token,
using the internal room ID (not a room alias or space ID), the
requirement for an unencrypted room (no E2EE support), and a note on
homeserver .well-known delegation.
@dgibbs64
dgibbs64 merged commit 8b49d87 into master Jul 19, 2026
2 of 4 checks passed
@dgibbs64
dgibbs64 deleted the docs/matrix-alerts branch July 19, 2026 21:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant