Skip to content

Notification Scripts

Notification helpers:

  • notify_discord.sh
  • notify_telegram.sh
  • notify_pushover.sh

They can be used by:

  • NOTIFY_SELFTEST_STATE_SCRIPT
  • NOTIFY_UNHEALTHY_SCRIPT

Optional shared override:

NOTIFY_MESSAGE=Custom message

Self-test transition context variables:

VPN_SELFTEST_PREVIOUS_STATE
VPN_SELFTEST_CURRENT_STATE
VPN_SELFTEST_WARN_COUNT
VPN_SELFTEST_FAIL_COUNT

Discord

Required:

DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/...

Telegram

Required:

TELEGRAM_BOT_TOKEN=123456:ABCDEF...
TELEGRAM_CHAT_ID=-1001234567890

Pushover

Required:

PUSHOVER_APP_TOKEN=your-app-token
PUSHOVER_USER_KEY=your-user-key