Skip to main content
Integrate Dokploy with Slack to receive real-time notifications about deployments, build failures, backups, and system events directly in your Slack channels.

​
Prerequisites

  • A Slack workspace where you have permission to add apps
  • Admin access to your Dokploy organization

​
Creating a Slack Webhook

1

Open Slack App Settings

Navigate to https://api.slack.com/apps and click Create New App
2

Create from Scratch

Select From scratch, name your app (e.g., “Dokploy Notifications”), and choose your workspace
3

Enable Incoming Webhooks

In your app settings:
  • Navigate to Incoming Webhooks in the left sidebar
  • Toggle Activate Incoming Webhooks to On
4

Create Webhook URL

  • Scroll down and click Add New Webhook to Workspace
  • Select the channel where you want to receive notifications
  • Click Allow to authorize the webhook
5

Copy Webhook URL

Copy the webhook URL that appears. It will look like:
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXX

​
Configuring Slack in Dokploy

1

Navigate to Notifications

In Dokploy, go to Settings > Notifications
2

Add Slack Notification

Click Add Notification and select Slack
3

Enter Configuration

Provide the following details:
  • Name: A descriptive name for this notification (e.g., “Production Alerts”)
  • Webhook URL: Paste the webhook URL from Slack
  • Channel: (Optional) Specify a channel name to override the default channel
4

Select Events

Choose which events should trigger Slack notifications:
  • Application Deploy
  • Application Build Error
  • Database Backup
  • Volume Backup
  • Dokploy Restart
  • Docker Cleanup
  • Server Threshold Exceeded
5

Test Connection

Click Test Connection to send a test message to your Slack channel:
Hi, From Dokploy 👋
Verify the message appears in your Slack channel.
6

Save Configuration

Click Save to activate the notification channel

​
Configuration Schema

The Slack notification configuration uses the following structure: 
{
  name: string,              // Display name for the notification
  webhookUrl: string,        // Slack webhook URL (required)
  channel: string,           // Optional channel override
  appDeploy: boolean,        // Enable for deployment notifications
  appBuildError: boolean,    // Enable for build failure alerts
  databaseBackup: boolean,   // Enable for database backup notifications
  volumeBackup: boolean,     // Enable for volume backup notifications
  dokployRestart: boolean,   // Enable for Dokploy restart alerts
  dockerCleanup: boolean,    // Enable for cleanup notifications
  serverThreshold: boolean   // Enable for resource threshold warnings
}

​
Notification Format

Slack notifications from Dokploy include:
  • Event Type: The type of event that triggered the notification
  • Timestamp: When the event occurred
  • Details: Event-specific information (application name, error message, etc.)
  • Status: Success or failure indicator

​
Example: Build Error Notification

{
  "channel": "#deployments",
  "text": "Build Error: my-app failed to build\nError: npm install failed\nTimestamp: 2024-02-28T10:30:00Z"
}

​
Channel Override

The optional channel parameter allows you to send notifications to a different channel than the webhook’s default: 
# Notifications go to the channel configured in the webhook
Webhook URL: https://hooks.slack.com/services/T00/B00/XXX
Channel: (empty) → uses webhook default
When specifying a channel override, ensure the Slack app has permission to post to that channel. You may need to invite the bot to private channels.

​
Troubleshooting

​
Test Connection Fails

Invalid webhook URL
  • Verify the webhook URL is correct and complete
  • Ensure the webhook hasn’t been revoked in Slack
  • Check that the URL starts with https://hooks.slack.com/services/
Channel not found
  • If using a channel override, verify the channel exists
  • Ensure the channel name includes the # prefix
  • For private channels, invite the Slack app to the channel

​
Not Receiving Notifications

Check event configuration
  • Verify the notification is enabled for the events you want to receive
  • Confirm events are being triggered in Dokploy (check logs)
Webhook permissions
  • Ensure the Slack app hasn’t been removed from the workspace
  • Check that the webhook URL is still valid in your Slack app settings
If you regenerate or delete a webhook in Slack, you must update the webhook URL in Dokploy. The old URL will stop working immediately.

​
Best Practices

​
Separate Channels by Severity

Create multiple Slack notifications with different channels:
  • #critical-alerts: App build errors, Dokploy restarts
  • #deployments: Successful deployments
  • #backups: Database and volume backup notifications
  • #monitoring: Server threshold warnings

​
Use Descriptive Names

Name your notification configurations clearly to identify their purpose:
  • ✅ “Production Build Failures”
  • ✅ “Staging Deployments”
  • ❌ “Slack 1”

​
Test Before Relying on Notifications

Always use the test connection feature to verify notifications work before assuming they’ll alert you during critical events.

​
API Integration

You can manage Slack notifications programmatically using the Dokploy API: 
const notification = await api.notification.createSlack({
  name: "Production Alerts",
  webhookUrl: "https://hooks.slack.com/services/...",
  channel: "#alerts",
  appDeploy: true,
  appBuildError: true,
  serverThreshold: true,
  databaseBackup: false,
  volumeBackup: false,
  dokployRestart: true,
  dockerCleanup: false
});

​
Next Steps

Discord Notifications

Set up Discord webhook integration

Telegram Notifications

Configure Telegram bot alerts

Email Notifications

Set up SMTP email notifications

Notification Overview

Learn about all notification options