observability

Alerts & Notifications

Get notified when your services need attention — via email, Discord, Slack, or webhooks.

Runix can notify you when something goes wrong with your services — a deploy fails, a service crashes, or a deploy succeeds. You choose how and where you want to be notified.

Notification Channels#

Set up notification channels in your dashboard under Notifications. Each channel defines where alerts are sent.

Channel	What it does
Email	Sends branded HTML alerts to an email address
Webhook	POSTs a JSON payload to any URL you specify
Discord	Sends messages to a Discord channel via webhook URL
Slack	Sends messages to a Slack channel via incoming webhook

Events That Trigger Alerts#

Event	When it fires
deploy.started	A new deployment build has begun
deploy.success	Your service deployed successfully and is live
deploy.failed	The deployment failed after all retries are exhausted

Failure notifications are only sent after the final retry attempt fails — you won't get spammed with false alarms during the build process.

Setting Up Email Alerts#

Go to Notifications

In the dashboard sidebar, click Notifications.

Add a channel

Click "Add Channel", select "Email", and enter the email address you want alerts sent to.

Choose events

Select which events should trigger notifications. Most people enable all three (started, success, failed).

Setting Up Discord / Slack#

Get a webhook URL

In Discord: Server Settings → Integrations → Webhooks → New Webhook → Copy URL.

In Slack: Apps → Incoming Webhooks → Add New Webhook → Copy URL.

Add the channel in Runix

Go to Notifications → Add Channel → Discord (or Slack) → Paste the webhook URL.

Test it

Click "Send Test" to verify the webhook is working. You should see a test message appear in your channel.

Webhook Payload Format#

When a webhook channel is triggered, Runix sends a POST request with this JSON body:

json

{
  "event": "deploy.success",
  "service_name": "my-api",
  "deployment_id": "550e8400-e29b-41d4-a716-446655440000",
  "subdomain": "my-api-x7kf",
  "timestamp": "2026-02-25T10:30:00Z",
  "url": "https://my-api-x7kf.runixcloud.dev"
}

You can set up multiple channels — for example, email for failures only and a Discord webhook for all events.

Overview