XMPP

The xmpp trigger sends notifications via XMPP (Jabber) instant messaging.

---

⚙️ Configuration Variables

WUD_TRIGGER_XMPP_{trigger_name}_PASSWORD

Requiredstring

XMPP account password

WUD_TRIGGER_XMPP_{trigger_name}_SERVICE

Requiredstring

XMPP server service URL (xmpps:// for direct TLS, xmpp:// for STARTTLS)

Allowed values:`xmpp://...`, `xmpps://...`, `ws://...`, `wss://...`

WUD_TRIGGER_XMPP_{trigger_name}_TO

Requiredstring

Recipient JID to send notifications to

Allowed values:Valid JID, e.g. `[email protected]`

WUD_TRIGGER_XMPP_{trigger_name}_USER

Requiredstring

XMPP account username (local part of the JID)

WUD_TRIGGER_XMPP_{trigger_name}_DOMAIN

Optionalstring

XMPP domain (inferred from JID if omitted)

WUD_TRIGGER_XMPP_{trigger_name}_TIMEOUT

Optionalintegerdefault: 10000

Maximum time in milliseconds to wait for the XMPP session (connect, authenticate and send) to complete before failing

Allowed values:Positive integer (milliseconds)

info

This trigger also supports all common trigger configuration options (such as thresholds, scheduling, and batching).

---

🚀 Examples

Send an XMPP Notification

Docker Compose

services:
  whatsupdocker:
    image: getwud/wud
    environment:
      - WUD_TRIGGER_XMPP_MAIN_SERVICE=xmpps://chat.example.com:5223
      - WUD_TRIGGER_XMPP_MAIN_DOMAIN=example.com
      - WUD_TRIGGER_XMPP_MAIN_USER=wud
      - WUD_TRIGGER_XMPP_MAIN_PASSWORD=mysecretpass
      - [email protected]

Docker

docker run \
  -e WUD_TRIGGER_XMPP_MAIN_SERVICE="xmpps://chat.example.com:5223" \
  -e WUD_TRIGGER_XMPP_MAIN_DOMAIN="example.com" \
  -e WUD_TRIGGER_XMPP_MAIN_USER="wud" \
  -e WUD_TRIGGER_XMPP_MAIN_PASSWORD="mysecretpass" \
  -e WUD_TRIGGER_XMPP_MAIN_TO="[email protected]" \
  getwud/wud