DeployCLI Reference
eda notify
Incident and health alert webhooks for Discord, Slack, and Telegram
The eda notify command group configures real-time notifications and incident alerting for your applications. When critical events occur (such as container crashes, failed deployments, or failed background cron jobs), Explita Deploy dispatches formatted alert payloads directly to your configured Discord channels, Slack channels, or Telegram chats.
eda notify [command] [options]
explita deploy notify [command] [options]1. Subcommands Overview
| Command | Description |
|---|---|
eda notify / eda notify ls | Display currently configured notification destinations for the application. |
eda notify set [options] | Configure webhook destinations, Telegram bot tokens, and subscribed event filters. |
eda notify test | Dispatch a live test notification to verify channel connectivity. |
eda notify rm [options] | Remove specific or all alert destinations (--all). |
2. Options
| Flag | Description |
|---|---|
--discord <url> | Discord incoming webhook URL. |
--slack <url> | Slack incoming webhook URL. |
--telegram <chat_id> | Telegram chat ID (or botToken:chatId). |
--telegram-token <token> | Telegram Bot API token (from @BotFather). |
--events <list> | Comma-separated list of events to trigger alerts on. |
-a, --app <appId> | Target application ID (defaults to local explita.json). |
--all | Remove all alert destinations (for eda notify rm). |
3. Supported Event Types
You can subscribe to all events or filter by specific incidents:
| Event Identifier | Description |
|---|---|
deployment_failed | Build failure, Dockerfile syntax error, or pre-deploy hook rejection (with log snippet). |
container_unhealthy | Container crashed, exited, was killed by OOM killer, or failed health check probes. |
cron_failed | Scheduled background cron job exited with a non-zero exit code. |
backup_completed | Automated database or system dump completed successfully. |
backup_failed | Automated database snapshot or offsite S3 sync failed. |
4. Usage Examples
Configure Discord Webhook
eda notify set --discord "https://discord.com/api/webhooks/12345/abcdef..."Configure Slack Webhook with Specific Events
eda notify set \
--slack "https://hooks.slack.com/services/T00/B00/XXXX" \
--events "deployment_failed,container_unhealthy,cron_failed"Configure Telegram Bot Alerts
eda notify set \
--telegram "-1001234567890" \
--telegram-token "1234567890:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"Test Notification Delivery
eda notify testDispatches a sample incident payload with live status indicators to all configured channels.
Remove Notifications
# Remove all destinations for current app
eda notify rm --all