Gotify

The gotify trigger sends real-time push notifications to self-hosted Gotify servers and clients.

---

⚙️ Configuration Variables

WUD_TRIGGER_GOTIFY_{trigger_name}_TOKEN

Requiredstring

Gotify application token

Allowed values:Valid Gotify application token

WUD_TRIGGER_GOTIFY_{trigger_name}_URL

Requiredurl

Gotify server base URL

Allowed values:Valid HTTP/HTTPS URL

WUD_TRIGGER_GOTIFY_{trigger_name}_EXTRAS

Optionaljson

Gotify extra message data (e.g. client::display for Markdown/HTML rendering or client::notification for click actions) see Gotify docs

Allowed values:JSON object or string

WUD_TRIGGER_GOTIFY_{trigger_name}_PRIORITY

Optionalintegerdefault: 5

Gotify notification priority level (0–10)

Allowed values:Integer >= `0`

info

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

---

🚀 Examples

Push Notifications to Gotify (with Markdown Support)

Docker Compose

services:
  whatsupdocker:
    image: getwud/wud
    environment:
      - WUD_TRIGGER_GOTIFY_LOCAL_URL=http://gotify.example.com
      - WUD_TRIGGER_GOTIFY_LOCAL_TOKEN=AWp8A.TbBO3xpn4
      - WUD_TRIGGER_GOTIFY_LOCAL_PRIORITY=5
      - WUD_TRIGGER_GOTIFY_LOCAL_EXTRAS={"client::display":{"contentType":"text/markdown"}}

Docker

docker run \
  -e WUD_TRIGGER_GOTIFY_LOCAL_URL="http://gotify.example.com" \
  -e WUD_TRIGGER_GOTIFY_LOCAL_TOKEN="AWp8A.TbBO3xpn4" \
  -e WUD_TRIGGER_GOTIFY_LOCAL_PRIORITY=5 \
  -e WUD_TRIGGER_GOTIFY_LOCAL_EXTRAS='{"client::display":{"contentType":"text/markdown"}}' \
  getwud/wud

Per-Container Override

services:
  my-app:
    image: my-app:1.2.0
    labels:
      - wud.trigger.gotify.extras={"client::display":{"contentType":"text/markdown"}}
      - wud.trigger.gotify.local.extras={"client::notification":{"click":{"url":"https://myapp.example.com"}}}

---

📖 Setup Guide: Obtaining a Gotify Token

1. Log in to your Gotify Web UI as an administrator.
2. Navigate to the Apps tab and click Create Application.
3. Name your app (e.g. WUD) and click Create.
4. Copy the generated Token and set it as WUD_TRIGGER_GOTIFY_{trigger_name}_TOKEN.