Monitoring and logs

Health checkCopy Anchor Link

The Relay exposes GET /health, which reports SQLite and Redis status:

curl -fsS https://your-relay.example/health   # {"status":"ok",...}

The Compose unit uses this endpoint as the Relay's healthcheck, and the web service checks /api/health. Caddy routes both.

LogsCopy Anchor Link

docker compose -f deploy/docker-compose.yml logs -f relay web docs caddy

Metrics to watchCopy Anchor Link

WebSocket auth failuresCopy Anchor Link

If the browser cannot open /ws, the Relay rejects it when ALLOWED_ORIGINS does not match the page origin. Check both ALLOWED_ORIGINS and the host you opened in the browser. Close code 4001 means the session was rejected and the client signs out.

RelatedCopy Anchor Link

• Configuration
• Troubleshooting