Skip to content

Notifications (ntfy)

The ntfy widget renders a live feed of recent messages from your ntfy server - served natively, with no adapter or proxy to run.

Set up the server once

In Settings → Integrations → Notifications (ntfy):

  • ntfy server base URL
  • Optional username / password for protected topics

This is the shared server config every ntfy widget uses.

Then add a widget per topic

On a service, choose the ntfy widget type and set:

FieldNotes
Topic(s)One or more topics, comma-separated: alerts,kuma,proxmox
Notifications to showHow many messages this widget shows (blank = use the default)
Look back (days)How far back to pull messages from

Both the count and the look-back are per widget, so one card can show 3 alerts while another shows 10.

How messages render

  • Each message shows a time and the message text, coloured by priority.
  • If a message has a title, it's shown bold on its own line above the body.
  • Long messages are collapsed to flowing text and clamped to two lines so a verbose notification doesn't blow up the card height.
  • A message containing a URL becomes clickable.

Clock & timezone

Message timestamps follow the clock format and timezone you set in Appearance → Weather & clock (12h / 24h and your zone) - not a per-ntfy setting.

Next steps