2026-01-08 05:34:03 -03:00
|
|
|
# services/comms/NOTES.md
|
|
|
|
|
|
|
|
|
|
Purpose: Matrix + Element + LiveKit stack for Othrys (live.bstein.dev).
|
|
|
|
|
|
|
|
|
|
Core flow
|
|
|
|
|
- Matrix Authentication Service (MAS) handles login/SSO and issues Matrix access tokens.
|
|
|
|
|
- Synapse is the homeserver; MAS fronts login, Synapse serves client/server APIs.
|
|
|
|
|
- Element Web provides the main UI; Element Call embeds LiveKit for group video.
|
|
|
|
|
- LiveKit handles SFU media; Coturn provides TURN for NAT traversal.
|
2026-01-08 11:56:35 -03:00
|
|
|
- matrix-guest-register provisions MAS guest accounts and performs MAS password login to mint device-bound guest tokens (no Keycloak).
|
2026-01-08 05:34:03 -03:00
|
|
|
|
|
|
|
|
Operational jobs
|
|
|
|
|
- mas-db-ensure-job: ensures MAS database role/database + secret in comms.
|
|
|
|
|
- comms-secrets-ensure-job: creates runtime secrets (TURN, LiveKit, Synapse, atlasbot).
|
|
|
|
|
- synapse-signingkey-ensure-job: ensures Synapse signing key secret.
|
|
|
|
|
- synapse-seeder-admin-ensure-job: ensures Synapse admin user exists.
|
|
|
|
|
- synapse-user-seed-job: seeds atlasbot + othrys-seeder users/passwords.
|
|
|
|
|
- mas-local-users-ensure-job: ensures MAS local users exist (seeder/bot).
|
|
|
|
|
- seed-othrys-room: (suspended) creates Othrys + joins locals.
|
2026-01-08 06:09:34 -03:00
|
|
|
- reset-othrys-room: suspended CronJob for a manual room reset + pin invite.
|
2026-01-08 05:34:03 -03:00
|
|
|
- pin-othrys-invite: (suspended) pin invite message if missing.
|
|
|
|
|
- guest-name-randomizer: renames numeric/guest users to adj-noun names.
|
|
|
|
|
- bstein-force-leave: one-off room leave cleanup.
|
|
|
|
|
|
|
|
|
|
Manual re-runs
|
|
|
|
|
- Unsuspend a CronJob only when needed; re-suspend after completion.
|
|
|
|
|
|
|
|
|
|
Ports
|
|
|
|
|
- Traefik (HTTPS) via LB on 192.168.22.9.
|
|
|
|
|
- Coturn LB on 192.168.22.5 (3478/5349 + UDP range).
|
|
|
|
|
- LiveKit LB on 192.168.22.6 (7880/7881/7882/7883).
|
