Browsing tree for branch master, showing 3 entries

Type	File	Last Commit	Author	Commit Date (UTC)	Size
txt	README.md	docs: Split README/wiki into docs/ folder	selfhoster1312	13:03, Sep 7 2025	1.31 KiB
txt	account.md	docs: Split README/wiki into docs/ folder	selfhoster1312	13:03, Sep 7 2025	6.13 KiB
txt	settings.md	docs: Split README/wiki into docs/ folder	selfhoster1312	13:03, Sep 7 2025	2.84 KiB

Slack

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

Configuration

Basic configuration example:

[slack]
[slack.myslack]
RemoteNickFormat="{BRIDGE} - @{NICK}"
Token="#####"
# this will maps threads from other bridges on slack threads
PreserveThreading=true

FAQ

How to get create an account for my matterbridge bot?

See account.md.

Auth Comparison

This is a simple comparison of the Slack connection methods, to help you understand and differentiate between each:

👇 Feature \ Token Type 👉	Bot user	Legacy (personal account)	Legacy (dedicated account)
Bridge Type	`slack`	`slack-legacy`	`slack-legacy`
Token prefix	`xoxb-`	`xoxp-`	`xoxp-`
Supported	✅		✅
1. Auto-join channels		✅	✅
3. Uses separate integration slot	:x:
4. User’s outgoing messages relayed	✅		✅
5. File uploads show as from…	bot	you	dedicated user

Messages come from Slack API tester

Did you set RemoteNickFormat?
Try adding RemoteNickFormat="<{NICK}>"

Messages from other bots aren’t getting relayed

If you’re using WebhookURL in your Slack configuration, this is normal. If you only have Token configuration, this could be a bug. Please open an issue.