Skip to main content
Connect DevHelm to Mattermost to receive incident notifications in your team channels. DevHelm posts to a Mattermost incoming webhook, so it works with both self-hosted and Mattermost Cloud instances.

​
Setup

1

Create a Mattermost incoming webhook

  1. In Mattermost, open Main Menu → Integrations → Incoming Webhooks
  2. Click Add Incoming Webhook
  3. Choose a display name (e.g., “DevHelm”) and a default channel
  4. Click Save and copy the generated webhook URL (e.g., https://mattermost.example.com/hooks/xxxxxxxxxxxx)
If you don’t see Incoming Webhooks, an administrator must enable them in System Console → Integrations → Integration Management.
2

Create the alert channel in DevHelm

devhelm alert-channels create \
  --name "Mattermost Alerts" \
  --type mattermost \
  --config '{"channelType":"mattermost","webhookUrl":"https://mattermost.example.com/hooks/xxxxxxxxxxxx"}'
3

Test the channel

devhelm alert-channels test <channel-id>

​
Configuration

FieldDescriptionRequired
webhookUrlMattermost incoming webhook URLYes
channelOverride the webhook’s default channel (e.g. incidents or @username)No
iconUrlPublicly accessible URL for a custom bot iconNo

​
Channel and icon overrides

channel and iconUrl only take effect if your Mattermost server permits webhook overrides. Enable System Console → Integrations → Integration Management → Enable integrations to override usernames and override profile picture icons. The iconUrl must be reachable from your Mattermost server — relative paths or internal-only URLs are ignored.

​
Troubleshooting

Incoming webhooks can be turned off per-server. Confirm an administrator has enabled System Console → Integrations → Integration Management → Enable Incoming Webhooks, and that the webhook itself hasn’t been deleted under Integrations → Incoming Webhooks.
The webhook posts to its configured default channel unless the server allows overrides. Enable Enable integrations to override usernames and icons in the System Console, then re-run devhelm alert-channels test <channel-id>.
DevHelm requires a valid TLS certificate for the webhook host. Install a certificate from a trusted CA (e.g. Let’s Encrypt) on your Mattermost instance — self-signed certificates are rejected during delivery.