EventBridge

Monitor one or more Cloudron instances and relay events (app lifecycle, tasks, notifications, platform updates) to your own webhook endpoints.

Features

• Multi-instance monitoring with per-monitor API tokens and poll intervals
• Event detection with deduplication and first-run baseline
• Signed webhooks (HMAC-SHA256) with retries, backoff, and jitter
• Server-rendered dashboard: monitors, destinations, event history, settings
• Optional email notifications via Cloudron's sendmail addon
• Self-monitoring awareness (excludes its own app events by default)

Setup

1. Install the app on your Cloudron.
2. Open the dashboard and add a monitor: give it a name, the Cloudron base URL (e.g. https://my.example.com), and an API token.
3. Add webhook destinations (global or per-monitor) and configure event subscriptions.
4. Copy the webhook signing secret from Settings and configure your receiver to verify X-CEB-Signature.

Webhook verification

Each webhook includes X-CEB-Timestamp (Unix seconds) and X-CEB-Signature (sha256=<hex HMAC>). The HMAC is computed over {timestamp}.{raw_body} with the signing secret shown in Settings.

Development

go build ./...
go test ./...

The app is a single static Go binary using SQLite for state, stored under /app/data.