main
- 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
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.
Languages
Python
99%
Dockerfile
1%