Skip to main content
Dokploy supports multiple notification channels to keep you informed about important events in your infrastructure. Configure channels to receive alerts when applications deploy, builds fail, backups complete, or server resources exceed thresholds.

​
Supported Channels

Dokploy integrates with the following notification services:

Slack

Send notifications to Slack channels via webhooks

Discord

Receive alerts in Discord channels with webhook integration

Telegram

Get instant notifications through Telegram bots

Email (SMTP)

Configure SMTP or use Resend for email notifications

​
Notification Events

Each notification channel can be configured to trigger on specific events:

​
Application Events

  • Application Deploy: Notifies when an application successfully deploys
  • Application Build Error: Alerts when application builds fail

​
Backup Events

  • Database Backup: Notifications for database backup completion or failure
  • Volume Backup: Alerts for Docker volume backup status

​
System Events

  • Dokploy Restart: Notifies when the Dokploy service restarts
  • Docker Cleanup: Alerts after Docker cleanup operations complete
  • Server Threshold: Warnings when CPU or memory usage exceeds configured thresholds

​
Configuration Workflow

1

Navigate to Notifications

Go to Settings > Notifications in the Dokploy dashboard
2

Choose a Channel

Select the notification service you want to configure (Slack, Discord, Telegram, or Email)
3

Enter Credentials

Provide the required credentials for your chosen service:
  • Webhook URLs for Slack, Discord
  • Bot token and chat ID for Telegram
  • SMTP settings or API key for Email
4

Select Events

Choose which events should trigger notifications to this channel
5

Test Connection

Use the test button to verify your configuration before saving

​
Managing Notifications

​
Multiple Channels

You can configure multiple notification channels simultaneously. For example, send build errors to Slack while routing backup notifications to email.

​
Event Filtering

Each notification destination has independent event filters. Configure granular control over which events trigger which channels.
All notification configurations are organization-scoped. Only organization administrators can create, update, or delete notification channels.

​
Server Threshold Notifications

Dokploy includes a built-in monitoring system that sends notifications when server resources exceed configured thresholds: 
{
  "ServerType": "Dokploy",
  "Type": "Memory",
  "Value": 85.5,
  "Threshold": 80,
  "Message": "Memory usage has exceeded threshold",
  "Timestamp": "2024-02-28T10:30:00Z"
}
Server threshold notifications require a valid token to be configured in your metrics settings. The token authenticates incoming threshold alerts from your monitoring agents.

​
Security Considerations

  • Webhook URLs: Store webhook URLs securely. They provide direct access to your notification channels
  • Credentials: All SMTP passwords and API tokens are encrypted in the database
  • Access Control: Only users with admin role can manage notification settings
  • Token Validation: Server threshold webhooks require token authentication to prevent unauthorized notifications

​
Next Steps

Configure Slack

Set up Slack webhook integration

Configure Discord

Connect Discord channels

Configure Telegram

Create Telegram bot notifications

Configure Email

Set up SMTP or Resend email