Skip to main content
Owner notifications declared in the StackSpec.
Subcommands: stackkit notify backup-digest, stackkit notify event, stackkit notify test

stackkit notify backup-digest

Send the backup digest to the owner notification channels. Read the local backup state without changing it and send one owner message: backup-failed when configuration, schedule, repository, the latest snapshot or a recovery objective needs attention; backup-restore-verification-overdue when only the staged restore proof is missing or older than the plan’s restoreVerification.maxEvidenceAgeDays; otherwise backup-digest. The message is sent only when its event is in spec.notifications.events (backup-digest is opt-in). It carries states and ages only, never a repository location or credential. Run it from a timer or an automation for a regular digest.
Examples

stackkit notify event

Send one lifecycle event to the owner notification channels. Send one lifecycle event to the owner notification channels. Use it from a timer or an automation for events StackKit does not observe by itself (upgrade-available, certificate-expiring); apply-failed and drift-detected are sent automatically by ‘stackkit apply’ and ‘stackkit drift detect’. The event is sent only when it is in spec.notifications.events. Facts are short states or counts; never put a path, repository location or credential in them.
Examples

stackkit notify test

Send a delivery check to the owner notification channels. Send a delivery check to every owner notification channel the verified ResolvedPlan declares (spec.notifications), or to one channel with --channel. The plan carries only a secret-free projection of each channel. The check reads the destination from the StackSpec on this server, refuses a channel whose destination no longer matches the verified plan, resolves credentials from local custody and records one receipt per channel under .stackkit/runs/owner-notifications. Receipts never contain the topic, recipients, credentials or message body.
Examples