Skip to main content

notify

notify — ɳSelf documentation.

Notify Plugin

Multi-channel notification dispatch: SMTP, SMS, and push. Free: MIT licensed.

Install

nself plugin install notify

What It Does

Provides a unified API for sending notifications across SMTP email, SMS, and push channels. Queues notifications and handles retries. Free tier supports SMTP, basic SMS, and push. For A/B testing, scheduled delivery, and user preferences, see Notify Pro.

Configuration

Env Var Default Description
NOTIFY_PORT 3052 Notify service port
NOTIFY_SECRET (auto-generated) Internal auth secret
NOTIFY_SMTP_HOST none SMTP server hostname
NOTIFY_SMTP_PORT 587 SMTP port
NOTIFY_SMTP_USER none SMTP username
NOTIFY_SMTP_PASS none SMTP password
NOTIFY_SMS_PROVIDER none SMS provider (twilio, etc.)
NOTIFY_FCM_KEY none Firebase Cloud Messaging key

Ports

Port Purpose
3052 Notify service REST API

Database Tables

2 tables added to your Postgres database:

  • np_notify_queue: queued notifications
  • np_notify_log: delivery history and status

Nginx Routes

None, notify service is internal only.

API

GET  /health: Health check
POST /notifications/email: Send email
POST /notifications/sms: Send SMS
POST /notifications/push: Send push notification
GET  /notifications: List notification history