How-To Series · Episode 32 / 59 · Module 5: Everywhere You Are

Hermes · On Mattermost

Self-hosted, open-source Slack. Same idea, less SaaS.

After this videoYou can now use Hermes in your Mattermost workspace.

Mattermost is Slack you run yourself. Hermes connects over its REST API v4 + WebSocket (no extra deps; Team Edition works) and behaves like it does on Slack: DMs answer all, channels need an @mention, per-user sessions. As System Admin, enable Bot Accounts in the System Console, create a bot (role Member) and copy its token (shown once). Add the bot to channels, grab your 26-char User ID (not your @username), then hermes gateway setup → Mattermost with the URL, token, and MATTERMOST_ALLOWED_USERS (or it denies all).

About these resources. Every command in this video comes from the Mattermost messaging doc.

Sources · What this video distills

1 docs page · every command below traces to one of them
Primary · REST + WebSocket model, bot account, token, User ID, gateway setup, MATTERMOST_* env vars, access control
Mattermost Setup
Read ↗

Commands shown · Copy and paste

each shows the source doc it came from
Wire + runfrom source ↗
hermes gateway setup && hermes gateway
Required envfrom source ↗
MATTERMOST_URL=https://mm.example.com MATTERMOST_TOKEN=*** MATTERMOST_ALLOWED_USERS=3uo8dkh1p7g1mfk49ear5fzs5c
Verify the tokenfrom source ↗
curl -H "Authorization: Bearer YOUR_TOKEN" https://your-server/api/v4/users/me

Going deeper · Related Hermes docs

further reading · not sources of facts shown above
Slack Setup
the SaaS sibling with the same behavior model
Matrix Setup
another self-hostable team chat

Next in the series · Episodes that build on this

E26
Hermes on Slack
E31
Hermes on Matrix
E34
Webhooks