Thumbnail

rani/matterbridge.git

Clone URL: https://git.buni.party/rani/matterbridge.git

Browsing tree for branch master, showing 2 entries

TypeFileLast CommitAuthorCommit Date (UTC)Size
txt README.md docs: Split README/wiki into docs/ folder selfhoster1312 13:03, Sep 7 2025 1.9 KiB
txt settings.md docs: Split README/wiki into docs/ folder selfhoster1312 13:03, Sep 7 2025 2.97 KiB
README.md

Mattermost

  • Status: ???
  • Maintainers: ???
  • Features: ???

[!WARNING] Create a dedicated user first. It will not relay messages from yourself if you use your account

Configuration

[!TIP] For detailed information about mattermost settings, see settings.md

Basic configuration example:

[mattermost.mymattermost]
RemoteNickFormat="[{PROTOCOL}] <{NICK}> "
# Don't use http or https scheme in the Server
Server="yourmattermostserver.domain:443"
# Uncomment if you're accessing your server over plaintext HTTP
#NoTLS=true

#the team name as can be seen in the mattermost webinterface URL
#in lowercase, without spaces
Team="yourteam"

Login="yourlogin"
Password="yourpass"

PrefixMessagesWithNick=true
PreserveThreading=true

FAQ

“version not supported error”

By default, matterbridge tries HTTPS to connect to your Mattermost setup.
If you’re using a test setup for Mattermost, this will probably listen on HTTP and on port 8065.

Add NoTLS=true and use Server="yourmattermostserver.domain:8065" to your Mattermost configuration.

Mattermost doesn’t show the IRC nicks

If you’re running the webhooks version, this can be fixed by either:

  • enabling “override usernames”. See mattermost documentation
  • setting PrefixMessagesWithNick to true in mattermost section of your matterbridge.toml.

If you’re running the login/password version, you’ll need to:

  • setting PrefixMessagesWithNick to true in mattermost section of your matterbridge.toml.

Also look at the RemoteNickFormat setting.

Session expire

Use personal access tokens that don’t expire, or increase the session timeout.