Skip to main content

ntfy alerts

Send kwatch incident alerts to ntfy. Use the interactive manager for installation and credential setup. This page explains the provider fields and shows a minimal configuration fragment.

Before you start, have these values ready:

  • topic — Topic to publish to.

Credentials, tokens, keys, passwords, and webhook URLs must be mounted from a Kubernetes Secret. Use an exact ${file:/absolute/path} reference for every field marked Secret.

Configuration​

FieldTypeRequiredSecretValidationDefaultDescription
topicstringyesyes——Topic to publish to
urlstringnonourlhttps://ntfy.shServer URL (default: https://ntfy.sh)
tokenstringnoyes——Optional auth token
titlestringnono——Custom title
priorityintegernonointeger4Priority 1-5 (default: 4)
routesjsonnonojson—Optional JSON route filters.
retry.maxAttemptsintegernonointeger—Optional maximum retry attempts.
retry.delaystringnono——Optional retry delay, for example 5s.
fallbackstringnono——Optional fallback provider name.

Minimal example​

alert:
ntfy:
topic: "${file:/config/ntfy-topic}"

Add routes, retry, and fallback when you need delivery filtering or recovery. See the channels overview for guidance, or the complete provider reference for the catalog-wide view.