Skip to content

Notification Servers

1. Notification Server Overview

Push notification server configuration for sending mobile notifications to subscription users. Supports self-hosted ntfy and Firebase Cloud Messaging (FCM).

General Fields

  1. Name - Server display name (required, tracked, translatable)
  2. Provider - Notification provider (required, tracked):
    • ntfy - Self-hosted ntfy server
    • fcm - Firebase Cloud Messaging
  3. Description - Server description
  4. Active - Whether the server is available (default: True)
  5. Is Default - Mark as default server for new subscriptions (tracked)
  6. Sequence - Display ordering

ntfy Provider Fields

  1. URL - Server URL, e.g., https://ntfy.sadeem.cloud (required for ntfy, tracked)
  2. Auth Enabled - Enable authentication for sending notifications (default: True, tracked)
  3. Auth Method - Authentication type (tracked):
    • password - Username/password authentication
    • token - Access token authentication
  4. Username - Sender username (for password auth)
  5. Password - Sender password (for password auth)
  6. Auth Token - Access token (for token auth, must start with tk_)
  7. Token Label - Label for the manual token
  8. Token Expiry - Manual token expiration date

ntfy Admin API (Auto-Token Mode)

  1. Admin Username - Admin credentials for the ntfy API (tracked)
  2. Admin Password - Admin password for API access
  3. Auto Generate Tokens - Automatically create per-subscription tokens (tracked)
  4. Token Expiry Days - Days until auto-generated tokens expire (default: 365)
  5. Token Prefix - Prefix for auto-generated token labels (default: Auto)

FCM Provider Fields

  1. FCM Project ID - Firebase project identifier (tracked)
  2. FCM Server Key - Legacy FCM server key
  3. FCM Service Account JSON - Firebase service account credentials (for FCM v1 API)

FCM Authentication

Either a Service Account JSON (recommended, for FCM v1 API) or a Legacy Server Key is required for Firebase integration.

2. Actions

Action Description
Test Connection Verify the server is reachable and responding
Test Admin Credentials Validate admin API access (ntfy only)
Test Token Check if the manual token is valid (ntfy only)
View Tokens Open token management wizard (ntfy with admin API)