Files
Matrix-Health-Monitor/README.md
T
Arvex c8fcbfb13e init: Matrix homeserver health monitor
- Auth, sync, messaging, media, rooms, federation, presence tests
- Light checks every 5min, full checks every 60min
- Reports to a dedicated Matrix monitoring room
- Telegram alerts on consecutive failures
- Docker container with healthcheck endpoint
- Auto-creates monitoring room if not configured
2026-04-05 09:58:28 -06:00

876 B

Matrix-Health-Monitor

Self-hosted Matrix homeserver monitoring bot that tests functionality from the inside out.

What it does

Periodically performs comprehensive tests against your Matrix homeserver:

  • Auth & Login -- verify tokens, measure response times
  • Sync Latency -- round-trip time for Matrix sync
  • Messaging -- send, receive, echo test in a test room
  • Media -- upload and download verification
  • Rooms -- create, join, invite, room state
  • Federation -- well-known resolution, federation check API
  • Presence -- presence state updates

Results

  • Formatted reports posted to a dedicated Matrix monitoring room
  • HTTP health endpoint (/health) for uptime monitors
  • JSON log files for trend analysis and dashboards

Deploy

docker compose up -d

Config

See docker-compose.yml for environment variables.