Beszel Push Notifications

Updated on September 19, 2026 Website GitHub

Send Beszel alerts and server monitoring events
directly to your mobile devices with Signalgrid.

Get started with Signalgrid See the Shoutrrr integration

Beszel is a lightweight monitoring tool for servers and infrastructure. Since v0.19.0, Beszel can send Signalgrid notifications natively through Shoutrrr, so you can receive alerts for downtime, resource issues, and recoveries right on your mobile devices.

Prerequisites

  • A working Beszel installation
  • A Signalgrid account
  • Outbound HTTPS access from your Beszel instance to Signalgrid

  Minimum Version Required

Signalgrid is supported in Beszel v0.19.0 and later.

Add Signalgrid to Beszel

  • Open Settings in Beszel and go to Notifications.
  • Create a new notification target using a Signalgrid Shoutrrr URL.
  • Save the notification target.
  • Enable alerts for the systems you want to monitor in the systems table.
  • Trigger a test alert or wait for a real event and confirm the notification arrives in Signalgrid.

Signalgrid URL Format

Beszel uses Shoutrrr URL schemas for notifications, so Signalgrid targets use the native Shoutrrr format:

  • signalgrid://CLIENT_KEY@CHANNEL
  • signalgrid://CLIENT_KEY@CHANNEL?title=Server%20Alert
  • signalgrid://CLIENT_KEY@CHANNEL?type=CRIT&critical=Yes

Parameters

Part
Description
CLIENT_KEY
Your Signalgrid client key from the Triggers section
CHANNEL
The Signalgrid channel token that should receive the Beszel alerts
title
Optional notification title override inside the Signalgrid URL
type
Optional Signalgrid notification type such as INFO, WARN, CRIT, or SUCCESS
critical
Optional urgent delivery flag for important alerts

Example notification targets

  • Basic target: signalgrid://YOUR_CLIENT_KEY@YOUR_CHANNEL_TOKEN
  • Warning alert target: signalgrid://YOUR_CLIENT_KEY@YOUR_CHANNEL_TOKEN?type=WARN
  • Critical alert target: signalgrid://YOUR_CLIENT_KEY@YOUR_CHANNEL_TOKEN?title=Server%20down&type=CRIT&critical=Yes

Because Beszel stores notification destinations as Shoutrrr URLs, you can paste one of these directly into the Beszel notifications settings.

How Beszel Uses Notifications

Beszel stores notification URLs in Settings > Notifications and uses them when system alerts are enabled. That means you can reuse the same Signalgrid target across one or more monitored systems without needing a webhook relay or custom bridge.

Manual Testing

After saving the notification target, send a test notification if your Beszel setup exposes one, or trigger a non-critical alert on a monitored system and confirm that the Signalgrid notification arrives on the expected channel.

Troubleshooting

Issue
What to check
The notification target is rejected
Make sure the URL begins with signalgrid:// and uses the Shoutrrr-style CLIENT_KEY@CHANNEL format
Beszel saves the target but no alert arrives
Verify the client_key, the channel token, and that your Beszel host can reach Signalgrid over HTTPS
You do not receive any notifications at all
Confirm that alerts are enabled for the relevant systems in Beszel, not just that the notification target exists

See also

Shoutrrr Push API Notification types
Any questions? Contact support.
LLM? Read llms.txt.
Visit us on GitHub