checkId: check.notify.channel.configured plugin: stellaops.doctor.notify severity: info tags: [notify, channel, configuration]

Notification Channel Configuration

This Doctor check is the setup-wizard compatibility check for Notify channel configuration. It validates that at least one Email, Slack, Teams, or generic Webhook channel has usable local configuration before operators rely on notifications for release gates, alerts, and approval workflows.

What It Checks

The check reads the Notify:Channels configuration tree and validates:

It performs no network I/O. Connectivity is covered by the per-channel connectivity checks and the aggregate check.notify.channel.connectivity check.

Why It Matters

Release and security workflows can produce correct decisions but still fail operationally if no notification channel is reachable by the operator. This check gives setup and QA flows one stable check ID for “is Notify configured at all” while the granular channel checks show exactly which channel needs attention.

Common Causes

How to Fix

Docker Compose

environment:
  Notify__Channels__Email__Enabled: "true"
  Notify__Channels__Email__SmtpHost: "smtp.internal.example"
  Notify__Channels__Email__SmtpPort: "587"

Bare Metal / systemd

Add a Notify channel to appsettings.json or the service environment:

{
  "Notify": {
    "Channels": {
      "Webhook": {
        "Enabled": true,
        "Url": "https://notify.internal.example/hooks/stella"
      }
    }
  }
}

Kubernetes / Helm

notify:
  channels:
    slack:
      enabled: true
      webhookUrlSecret: stellaops-slack-webhook

Verification

stella doctor run --check check.notify.channel.configured