Notifications
Deliver alerts through Telegram, ntfy, Gotify, Discord, Webhook, or system notifications.
Dockerman delivers alerts through configured channels. Each channel uses a Shoutrrr-compatible URL scheme, the same format Watchtower, Beszel, and similar tools use.
Supported channels
| Channel | URL format | Notes |
|---|---|---|
| Telegram | telegram://token@telegram?chats=chat_id | Bot token from BotFather |
| ntfy | ntfy://ntfy.sh/topic or ntfy://user:pass@ntfy.sh/topic | Self-hosted or ntfy.sh |
| Gotify | gotify://gotify.example.com/token | Self-hosted Gotify server |
| Discord | discord://token@id | Webhook URL converted to Shoutrrr format |
| Webhook | generic://example.com/webhook | Generic JSON POST to any endpoint |
| System notification | Built-in, no URL needed | macOS, Windows, and Linux native notifications |
System notifications are always available and enabled by default. They do not count as an "external" channel.
Current desktop support
The Notifications page can list configured channels and send a test notification. The current desktop UI does not provide a complete add, edit, disable, or delete workflow. The underlying notification adapters are not a supported substitute for that missing UI.
Credential security
The current daemon stores complete notification channel secrets in secrets/notification-channels.json inside the Dockerman application data directory. On Unix, Dockerman restricts the file permissions to the current user, but the values are not stored in the system Keychain.
Treat the Dockerman application data directory as sensitive. Generic webhook URLs may contain credentials in their path or query string; review logs and diagnostic data before sharing them.
Where notifications are used
Notification channels are consumed by two systems:
Alert Rules
Each alert rule binds to one or more channels. When the rule fires, it sends to all bound channels.
Image Upgrade Watches
Image watches use a global default channel list. When a new image version is found, all default channels receive the notification.
Tips
- If you already use Shoutrrr URLs with Watchtower or Beszel, you can paste the same URL into Dockerman.
- For Discord, convert your webhook URL (
https://discord.com/api/webhooks/ID/TOKEN) to the Shoutrrr format:discord://TOKEN@ID. - The generic webhook channel sends a JSON POST with
titleandbodyfields. Use it with services that accept a JSON webhook POST.