How to set up Slack
stromboli posts one message per investigation: the mitigation as soon as it is proposed, then the report, updated in place. It also replies in the message’s thread so on-call is notified, and posts machine action outcomes there. The bot only needs the chat:write scope.
1. Create the app from the manifest
The app is described in deploy/slack/manifest.json.
- Go to api.slack.com/apps → Create New App → From a manifest, and pick your workspace.
- Paste the manifest. Before creating the app, replace
stromboli.example.cominrequest_urlwith stromboli’s public URL, or delete theinteractivityblock if you won’t use Apply/Reject buttons.
2. Install it
Install App → Install to Workspace, then copy the Bot User OAuth Token (xoxb-...).
3. Invite the bot
In the channel where reports should go:
/invite @stromboli
4. Configure stromboli
Set these variables and restart the server:
SLACK_BOT_TOKEN=xoxb-...
SLACK_CHANNEL=#incidents # a name or a channel ID (C0123...)
Both are required: with only one, Slack stays off and the server logs Slack is not configured.
5. Check it
stromboli investigate <service> --description "testing Slack"
The message should appear in the channel. If it doesn’t, look at the server logs:
| Log | Fix |
|---|---|
not_in_channel |
the bot is not in the channel: step 3 |
invalid_auth |
wrong token: step 2 |
channel_not_found |
wrong SLACK_CHANNEL, or a private channel the bot was not invited to |
Optional
- Approve machine actions from Slack with
SLACK_SIGNING_SECRETandSLACK_APPROVERS. - Post an all-clear after healthy health check runs with
STROMBOLI_HEALTHCHECK_SUMMARY=true.