Installation¶

Pre-built Binaries¶

Download the latest release from GitHub Releases.

Archives are available for:

OS	Architecture
Linux	amd64, arm64
macOS	amd64 (Intel), arm64 (Apple Silicon)
Windows	amd64, arm64

Extract and run:

tar xzf smqbroker_*.tar.gz
./smqbroker --config smqbroker.yaml

Docker¶

docker pull ghcr.io/goodtune/slackmq:latest

docker run -e SLACK_BOT_TOKEN=xoxb-... \
           -e SLACK_APP_TOKEN=xapp-... \
           -p 9090:9090 \
           ghcr.io/goodtune/slackmq:latest

Build from Source¶

Requires Go 1.25+:

git clone https://github.com/goodtune/SlackMQ.git
cd SlackMQ
make build
./bin/smqbroker --config smqbroker.yaml

Slack App Setup¶

The broker requires a Slack app with Socket Mode enabled.

Required Bot Token Scopes¶

channels:history — read messages in public channels
channels:join — join channels as needed
chat:write — post fan-out messages and notifications
reactions:read — monitor ACK/NACK reactions
reactions:write — add protocol emoji to messages
commands — register /smq slash command

Required Event Subscriptions¶

message.channels — new messages in channels
reaction_added — emoji reactions on messages
reaction_removed — removed emoji reactions

Environment Variables¶

export SLACK_BOT_TOKEN=xoxb-your-bot-token
export SLACK_APP_TOKEN=xapp-your-app-token