Skip to main content

Setup Mattermost for Console

Users are dynamically created upon logging in to Mattermost, so you'll need to log in to Mattermost as the console-bot before proceeding.

Enable Personal Access Tokens for Admins:

  1. Log in to Mattermost with an admin-level account.
  2. The user will be prompted to create a team. This can be named/configured to the user's preference.
  3. Click the 9 dot icon in the top-left corner (left of the Mattermost logo).
  4. Click System Console.
  5. Click Integration Management in the left-hand panel.
  6. Enable Personal Access Tokens: True.
  7. Click Save.
  8. Leave System Console by clicking Back to <team name>.

Enable Admin for console-bot:

  1. Log in using a Mattermost admin-level account.
  2. Click the 9 dot icon in the top-left corner (left of the Mattermost logo).
  3. Click System Console.
  4. Navigate to User Management -> Users.
  5. Find console-bot, and in the Actions column, select Manage Roles and set to System Admin.
  6. Click Save.

Create Personal Access Token:

  1. Log in to Mattermost as console-bot.
  2. Click the profile icon in the top-right corner.
  3. Click Profile.
  4. Click Security.
  5. Click Edit for Personal Access Tokens.
  6. Click Create Token:
    1. Token Description: console-bot-admin-integration.
    2. Click Yes, Create.
  7. Save Access Token value.
console:
values:
backend:
mattermost:
enabled: "true"
host: "chat.<DOMAIN>" # this value can be omitted but is required when setting a custom subdomain for Mattermost.
accessToken: "<Mattermost Access Token Value>"
caution

Removing or altering permissions in Mattermost for console-bot after access tokens have been set could lead to unexpected issues.