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

Hermes · On Matrix

Open, federated chat. Any homeserver. Optional E2EE.

After this videoYou can now run Hermes in Matrix rooms.

Matrix is an open, federated protocol; run your own homeserver or use matrix.org. Hermes connects via mautrix as a normal user. Give the bot an account, grab an access token (Element → Settings → Help & About → Advanced) or use password login, then hermes gateway setup → Matrix with MATRIX_HOMESERVER + MATRIX_ACCESS_TOKEN + MATRIX_ALLOWED_USERS (or it denies all). Invite the bot and it auto-joins; DMs answer everything, rooms need an @mention. Optional end-to-end encryption via the matrix extra + libolm + MATRIX_ENCRYPTION=true (Apple Silicon uses proxy mode).

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

Sources · What this video distills

1 docs page · every command below traces to one of them
Primary · behavior, bot account, token vs password login, gateway setup, MATRIX_* env vars, invite/auto-join, E2EE
Matrix 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 ↗
MATRIX_HOMESERVER=https://matrix.example.org MATRIX_ACCESS_TOKEN=*** MATRIX_ALLOWED_USERS=@you:matrix.example.org
Optional E2EEfrom source ↗
pip install 'mautrix[encryption]' # + libolm, then MATRIX_ENCRYPTION=true

Going deeper · Related Hermes docs

further reading · not sources of facts shown above
Messaging overview
the gateway model behind every platform
Mattermost Setup
another self-hostable team chat

Next in the series · Episodes that build on this

E28
Hermes on Signal
E32
Hermes on Mattermost
E26
Hermes on Slack