# Mattermost

## Set up on Mattermost <a href="#set-up-on-mattermost" id="set-up-on-mattermost"></a>

1. Follow [the steps provided by Mattermost to create a channel](https://docs.mattermost.com/channels/create-channels.html).
2. We recommend that you [follow their naming conventions](https://docs.mattermost.com/channels/channel-naming-conventions.html) when you name the channel.
3. Note two strings:
   * The **URL** of your Mattermost service (look in the address bar of your browser).
   * The **channel name**.

## Create a Lightup alerting channel that uses Mattermost <a href="#create-a-lightup-alerting-channel-that-uses-mattermost" id="create-a-lightup-alerting-channel-that-uses-mattermost"></a>

You'll need to get the values for **URL** and **Mattermost Channel** from your Mattermost service.

1. In the left nav, on your workspace menu select **Integrations**. Your current integrations appear in the main Lightup form.
2. In the main Lightup form, select **+** near the top left corner to create a new channel, and then choose **Mattermost channel**.
3. In the **Add Mattermost integration** dialog, enter a value for **Name** - this becomes the _Title_ of the integration when it's listed in the main Lightup form.
4. Both **URL** and **Mattermost Channel** come from the Flock side. Enter the values you noted when you created the channel on Mattermost.
5. Be sure to set your time zone.
6. Under **Post Alerts to this channel**, select the frequency at which the channel will receive new alerts. All posts happen at the beginning of the period indicated by the frequency and cover alerts in the previous period; for example, an hourly post is a digest of all alerts in the preceding hour.
7. Use the toggles to choose whether to post daily digests and send alerts for resolved incidents.
8. Optionally, select **Send test message** to test the new channel.
9. Select **Add** to finish.
