checkId: check.notify.slack.configured plugin: stellaops.doctor.notify severity: warn tags: [notify, slack, quick, configuration]
Slack Configuration
This Doctor check verifies that the Slack notification channel has a webhook URL set before Stella Ops attempts to deliver alerts to Slack. It is a fast, local-only configuration check aimed at operators setting up or troubleshooting notifications; for the network probe, see check.notify.slack.connectivity.
What It Checks
Verifies that the Slack notification channel is properly configured. The check reads Notify:Channels:Slack and validates:
- Webhook URL (
WebhookUrl): must be set and non-empty. - Enabled flag (
Enabled): if explicitlyfalse, reports a warning that Slack is configured but disabled.
The check only runs when the Notify:Channels:Slack configuration section exists.
Why It Matters
Slack is a primary real-time notification channel for many operations teams. Without a configured webhook URL, security alerts, release gate notifications, and approval requests cannot reach Slack channels, delaying incident response.
Common Causes
- Slack webhook URL not set in configuration
- Missing
Notify:Channels:Slack:WebhookUrlsetting - Environment variable not bound to configuration
- Slack notifications explicitly disabled
How to Fix
Docker Compose
environment:
Notify__Channels__Slack__WebhookUrl: "https://hooks.slack.com/services/YOUR/WEBHOOK/URL"
Security note: Slack webhook URLs are secrets. Store them in a secrets manager or Docker secrets, not in plain-text compose files.
Bare Metal / systemd
Edit appsettings.json:
{
"Notify": {
"Channels": {
"Slack": {
"WebhookUrl": "https://hooks.slack.com/services/YOUR/WEBHOOK/URL"
}
}
}
}
Kubernetes / Helm
notify:
channels:
slack:
webhookUrlSecret: "stellaops-slack-webhook"
Create the secret:
kubectl create secret generic stellaops-slack-webhook \
--from-literal=url="https://hooks.slack.com/services/YOUR/WEBHOOK/URL"
Verification
stella doctor run --check check.notify.slack.configured
Related Checks
check.notify.slack.connectivity— tests whether the Slack webhook endpoint is reachablecheck.notify.queue.health— verifies the notification delivery queue is healthy
