Open-source push. Self-host for full local sovereignty (mobile + desktop apps).
Where to get it
Self-host the open-source ntfy server (or use ntfy.sh). github.com/binwiederhier/ntfy
Install / what you need
Self-host: `docker run -p 80:80 binwiederhier/ntfy serve`. Or point at any ntfy server.
How to connect
- 1 Stand up an ntfy server (or pick a topic on a server you trust).
- 2 Open the dashboard's Notifications panel → Add destination → choose ntfy, fill in the server URL + topic.
- 3 Subscribe on your phone/desktop ntfy app.
- 4 Hit Send test on the destination card — priority, tags, and click-actions supported.
When you'd use it
What Herald sends through this channel
4 setup fields
Herald hands every alert to the
NtfyAdapter
as a DispatchPlan. The fields
below are what the dashboard form asks for; the sample is the plan the adapter receives.
The adapter renders it into the channel-native shape (Discord embeds, Teams MessageCards,
PagerDuty Events-API payloads, TwiML, JSON POST bodies) on the way out — that wire transcript varies per channel.
Setup form fields
| field | type | required | description / default |
|---|---|---|---|
| server_url | string | optional | ntfy server base URL (self-host for LOCAL sovereignty) · default: "https://ntfy.sh" |
| topic | string | required | ntfy topic to publish to |
| auth_token | string | optional | Bearer token if topic is protected |
| timeout_seconds | number | optional | no description · default: 10 |
Sample DispatchPlan (input to the adapter)
{
"decision_id": "tdc-2026-06-20-abc12",
"channel": "<channel-type>",
"recipient": {
"recipient_id": "soc-oncall",
"display_name": "SOC on-call",
"addresses": [
{
"channel": "<channel-type>",
"address": "<destination>",
"min_defcon": 5
}
]
},
"urgency": "high",
"retry_policy": {
"max_attempts": 3,
"initial_backoff_seconds": 5
},
"subject": "Suspicious login on CEO-LAPTOP",
"body": "Warden flagged a PowerShell child of WINWORD.EXE. The encoded command resolved to a base64-wrapped Invoke-WebRequest to a newly-registered domain. Trust ladder: L3.",
"approval_link": "https://app.cybercli.local/approve/abc12",
"incident_ref": "case-2026-0142",
"signal_id": "sig-2026-06-20-9f3"
} Sovereignty: byo_external · Min tier (BYO): free · Open-source push; self-host for LOCAL sovereignty.
Self-host it and the alert never leaves your network — push without an app-store middleman.
Herald — the Guild's voice role — routes alerts, daily digests, and AI verdicts here, on a per-CYCON-state matrix you control. CYCON 1/2 alerts repeat until an operator acks.
The Guild →