Skip to content

Push Notifications

Ntfy + Apprise integration for alerts

The Push Notifications plugin sends PegaProx alerts to mobile devices and messaging platforms. Supports Ntfy (self-hosted or cloud) and optionally Apprise for 80+ services.

Setup

  1. Enable the plugin in Settings → Plugins.

  2. Open the plugin config and set your Ntfy URL + topic (e.g., https://ntfy.sh with topic pegaprox-alerts).

  3. Optionally add Apprise URLs for Slack, Discord, Telegram, etc.

  4. Click Test to verify the connection.

Configuration

Setting Description
ntfy_enabled Enable Ntfy push notifications
ntfy_url Ntfy server URL (default: https://ntfy.sh)
ntfy_topic Topic name for your alerts
ntfy_token Bearer token for authenticated Ntfy servers
apprise_enabled Enable Apprise multi-service notifications
apprise_urls Array of Apprise service URLs (e.g., slack://token, discord://webhook)

Ntfy severity mapping: critical → max priority, warning → high, info → default. Apprise uses its own notification types (FAILURE, WARNING, INFO) mapped from the same severity levels. Install Apprise with pip install apprise for multi-service support.

API Endpoints

Method Endpoint Description
GET /api/plugins/notifications/api/config Get notification config (admin only)
POST /api/plugins/notifications/api/config/update Update config
POST /api/plugins/notifications/api/test Send test notification