Mattermost Notifications Service
The Mattermost Notifications Service allows your GitLab project to send events (e.g., issue created
) to your existing Mattermost team as notifications. This requires configurations in both Mattermost and GitLab.
You can also use Mattermost slash commands to control GitLab inside Mattermost. This is the separately configured Mattermost slash commands.
On Mattermost
To enable Mattermost integration you must create an incoming webhook integration:
- Sign in to your Mattermost instance.
- Visit incoming webhooks, that will be something like:
https://mattermost.example.com/your_team_name/integrations/incoming_webhooks/add
. - Choose a display name, description and channel, those can be overridden on GitLab.
- Save it, copy the Webhook URL, we’ll need this later for GitLab.
Incoming Webhooks might be blocked on your Mattermost instance. Ask your Mattermost admin to enable it on:
- Mattermost System Console > Integrations > Integration Management in Mattermost versions 5.12 and later.
- Mattermost System Console > Integrations > Custom Integrations in Mattermost versions 5.11 and earlier.
Display name override is not enabled by default, you need to ask your admin to enable it on that same section.
On GitLab
After you set up Mattermost, it’s time to set up GitLab.
Navigate to the Integrations page and select the Mattermost notifications service to configure it. There, you will see a checkbox with the following events that can be triggered:
- Push
- Issue
- Confidential issue
- Merge request
- Note
- Confidential note
- Tag push
- Pipeline
- Wiki page
- Deployment
Below each of these event checkboxes, you have an input field to enter
which Mattermost channel you want to send that event message. Enter your preferred channel handle (the hash sign #
is optional).
At the end, fill in your Mattermost details:
Field | Description |
---|---|
Webhook | The incoming webhook URL which you have to set up on Mattermost, it will be something like: http://mattermost.example/hooks/5xo…
|
Username | Optional username which can be on messages sent to Mattermost. Fill this in if you want to change the username of the bot. |
Notify only broken pipelines | If you choose to enable the Pipeline event and you want to be only notified about failed pipelines. |
Help and feedback
If there's something you don't like about this feature
To propose functionality that GitLab does not yet offer
To further help GitLab in shaping new features
If you didn't find what you were looking for
If you want help with something very specific to your use case, and can use some community support
POST ON GITLAB FORUM
If you have problems setting up or using this feature (depending on your GitLab subscription)
REQUEST SUPPORT
To view all GitLab tiers and features or to upgrade
If you want to try all features available in GitLab.com
If you want to try all features available in GitLab self-managed
If you spot an error or a need for improvement and would like to fix it yourself in a merge request
EDIT THIS PAGE
If you would like to suggest an improvement to this doc