Skip to content

Notifications

github-actions[bot] edited this page May 28, 2026 · 3 revisions

Notifications

Sentry USB can send you push notifications when:

  • An archive succeeds or fails
  • A drive fills up
  • Sentry events fire
  • The BLE keep-awake loses pairing
  • The Pi reboots or loses WiFi

Configure providers in the Setup Wizard, or anytime later under SettingsNotifications.

You can enable as many providers as you want at once.

Providers

Pushover

Paid one-time-fee iOS / Android app. Most reliable for personal alerts.

Field Where to get it
User Key Pushover dashboard → your user key
App Key Create an Application in the Pushover dashboard

ntfy

Free, self-hostable push notifications. Subscribe to a topic on the ntfy.sh iOS / Android app.

Field Example
URL & Topic https://ntfy.sh/your-secret-topic
Access Token (optional, only for self-hosted with auth)
Priority 3 (1=lowest, 5=highest)

Gotify

Self-hosted push notification server. You run Gotify on a home server; the Android app receives the push.

Field Example
Domain https://gotify.example.com
App Token Created in the Gotify web UI under Apps
Priority 5

Discord

Posts to a Discord channel via a webhook.

Field Where to get it
Webhook URL Server Settings → Integrations → Webhooks → New Webhook → Copy URL

Telegram

Posts via a Telegram bot.

Field Where to get it
Chat ID Send a message to your bot, then visit https://api.telegram.org/bot<TOKEN>/getUpdates
Bot Token Create a bot with @BotFather

Slack

Posts to a Slack channel via an Incoming Webhook.

Field Where to get it
Webhook URL Slack App settings → Incoming Webhooks → Add to channel

Signal

Sends via signal-cli running on your network.

Field Example
Signal CLI URL http://signal-host:8080
From Number +15555550100
To Number +15555550199

Matrix

Posts to a Matrix room.

Field Example
Server URL https://matrix.org
Username yourname
Password your password
Room ID !roomid:matrix.org

AWS SNS

For automation / cloud workflows.

Field Example
Region us-east-1
Access Key ID AKIA...
Secret Key your secret
Topic ARN arn:aws:sns:us-east-1:123:my-topic

IFTTT

Triggers an IFTTT applet by sending an event.

Field Where to get it
Event Name Whatever you named the event in your applet
Key IFTTT Webhooks service → Documentation page → your key

Webhook

Generic — POSTs a JSON payload to any URL. Useful for Home Assistant, n8n, Node-RED, etc.

Field Example
Webhook URL http://homeassistant.local:8123/api/webhook/sentryusb

Mobile App (beta)

Push notifications to the Sentry USB iOS companion app. Currently in beta. Toggle it on in the wizard if you've installed the app and paired it.


Testing notifications

After the wizard finishes, SettingsNotificationsSend Test fires a test message to every enabled provider so you can confirm setup.

Clone this wiki locally