Discord
Coolify sends Discord notifications through an incoming webhook created for a Discord text channel.
Create a Discord webhook
Choose the destination
Open the Discord server that should receive Coolify notifications. Create a text channel, such as coolify-notifications, or select an existing one.
You need permission to manage webhooks in that server.
Create the webhook
- Open Server Settings > Integrations > Webhooks.
- Select New Webhook.
- Give the webhook a recognizable name, such as
Coolify. - Select the text channel that should receive its messages.
- Select Copy Webhook URL.
See Discord's webhook documentation for provider-specific details.
Protect the webhook URL
Anyone with the URL can post to the Discord channel. Store it as a secret and replace the webhook if the URL is exposed.
Configure Coolify
- Open Notifications > Discord.
- Paste the URL into Webhook and select Save.
- Turn on Enabled.
- Optional: turn on Ping Enabled to add
@hereto critical event notifications. Discord notifies only members who are online and can access the channel. - Under Notification Settings, select the events to send to Discord.
- Select Send Test Notification.
Confirm that the test appears in the selected Discord channel before selecting additional events.
Troubleshoot Discord delivery
If the test does not appear:
- Return to Server Settings > Integrations > Webhooks and confirm that the webhook still exists.
- Confirm that it targets the channel you are checking. A webhook can be moved to another channel without changing the workflow in Coolify.
- Copy the URL again and replace the saved value in Coolify if the webhook was recreated or its token changed.
- Confirm that the destination channel still exists and that the webhook can post to it.
- Save the URL before turning on Enabled, then send another test.
See Notification events for the trigger behind each event setting.