← All channels

Matrix

beta

Federated chat, end-to-end encrypted rooms.

In
Out
Auth
Access token
§ Required environment

Env vars

IRIS_MATRIX_HOMESERVER
Required

Homeserver URL, e.g. https://matrix.org.

IRIS_MATRIX_USER_ID
Required

Full Matrix user ID for the agent (e.g. @iris:matrix.org).

IRIS_MATRIX_ACCESS_TOKEN
Required

Long-lived access token for the account.

§ Setup

Step by step

  1. 01

    Create an account

    Register a Matrix account on a homeserver you trust, then generate a long-lived access token from a logged-in client.

  2. 02

    Export credentials

    Save the homeserver, user ID, and access token.

    export IRIS_MATRIX_HOMESERVER="https://matrix.org"
    export IRIS_MATRIX_USER_ID="@iris:matrix.org"
    export IRIS_MATRIX_ACCESS_TOKEN="syt_..."
  3. 03

    Enable the channel

    Iris.Md will join any room it is invited to.

    iris channels enable matrix
§ Success

You're done when

  • Agent shows online status on its profile
  • Invites to rooms are auto-accepted
  • Encrypted messages are decrypted correctly