Unraid
Her Unraid bildirimini iPhone'unuza ileten ve parity kontrollerini, yedeklemeleri, mover ve UPS olaylarını kilitli ekranınızda canlı etkinlikler olarak gösteren yerel bir Unraid eklentisi.
Beta. The plugin works but expect some rough edges — please report any issues.
How It Works
A native Unraid plugin — no Docker container, and no Unraid API key. It installs a Dynamix notification agent plus a small background monitor that reads Unraid's own state, and talks to the PushWard REST API over HTTPS.
- Notifications — the agent forwards every Unraid notification to your iPhone.
ALERTandWARNINGmap to active iOS pushes, everything else to passive (turn onINFOtoo under Settings → Notifications). The full message body is sent, not just the subject. - Live Activities — a background monitor (started by an array-event hook, kept alive by a 1-minute watchdog cron) reads Unraid's state and drives Live Activities for long-running jobs. They appear via push-to-start with no app interaction, update as the job runs, and end automatically when it finishes.
| Source | What you see |
|---|---|
| Parity check / rebuild / clear | Percent complete, speed, ETA, and the error count on parity checks |
| Appdata backup | Step-by-step progress, one step per container |
| Mover | Files listed as they move, with percent and transfer speed |
| VM backup | Step-by-step progress, one step per VM |
| UPS on battery | Battery charge and runtime countdown while running on battery |
The monitor only reads status — it never touches Unraid or the source plugins — and stays under your
PushWard update quota by pushing only on a meaningful change. A few notes on the file-level sources:
the mover lists files only when Mover logging is on (Settings →
Scheduler → Mover Settings); with it off you get a percent and bytes bar instead. VM
backup tracks the vmbackup plugin's own scheduled or manual runs. The UPS source reads apcupsd via apcaccess and only appears while on battery (NUT is not
supported).
Setup
1. Get Your PushWard Integration Key
PushWard uygulamasında Ayarlar → Entegrasyon Anahtarı altındaki varsayılan entegrasyon anahtarınızı kullanın veya bu entegrasyon için kapsamı sınırlı bir anahtar oluşturun.
One hlk_ key covers both features. Notifications need notifications at send or above and work on any plan; Live Activities need activities at manage and an active PushWard subscription.
2. Install the Plugin
In the Unraid web UI, open Plugins → Install Plugin and paste:
https://github.com/mac-lucky/pushward-unraid-plugin/raw/main/pushward-unraid.plgUnraid 6.12 or later is required.
3. Configure
Open Settings → PushWard (in the User Utilities row). On the Settings tab, fill in:
| Field | Description | Default | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Live Activities | Master switch for progress activities | On | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| PushWard server URL | PushWard API URL | https://api.pushward.app | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| PushWard API key | The hlk_… key from step 1 | -- | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Server display name | Shown under notifications and used to name activities (e.g. "Tower") | Unraid | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Track parity / appdata backup / mover / VM backup / UPS | Per-source toggles for the Live Activities above | On | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Poll interval | How often the monitor checks state | 15s | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Activity priority | 0–10, used when PushWard evicts to make room for higher-priority activities | 5 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 1.17.0 uygulama sürümünde geliyor | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Repeat alerts until acknowledged | Repeat every notification that arrives as an Unraid alert until you acknowledge it | Disabled | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Repeat every (seconds) | Time between repeats, 30-3600 | 300 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Stop repeating after (seconds) | How long an alert nobody acknowledges keeps repeating, 60-10800 | 3600 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| End-to-end encryption key | Optional. The key from the PushWard app that turns on end-to-end encryption | -- | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Click Apply, then use the test buttons to confirm each path. The Settings tab shows
live status — whether the key is valid, the subscription is active, and the monitor is running.
Values are saved under /boot/config/plugins/pushward-unraid/ and survive reboots and
plugin upgrades. The Activities tab lists the current Live Activities and lets you
end them.
Bu bölüm, App Store incelemesini bekleyen bir uygulama güncellemesindeki bir özelliği açıklar. Güncelleme yayınlanır yayınlanmaz burada otomatik olarak açılır.
Repeat alerts until acknowledged
Plugin 2026.10.08 and later can repeat an alert until someone takes notice. It is off by default. Set Repeat alerts until acknowledged to Enabled and every notification that arrives as an Unraid alert comes back every Repeat every seconds (300 by default, 30 to 3600) until you tap Acknowledge on one of your devices, or until Stop repeating after runs out (3600 by default, 60 to 10800). Warnings and info notices never repeat. The test notification is sent as an alert, so it is an easy way to try it.
- When a later notification for the same event is not an alert, such as Unraid's notice that a disk returned to normal, the plugin stops that event's repeats before sending it, so the remaining repeats do not cover the good news. The repeats of other events carry on.
- Notifications sent without an event name (Unraid's
notifywithout-e) are grouped by their subject instead, so each subject counts as one event (2026.10.08a and later). - Turning the setting off does not stop repeats that are already running. Those stop when someone acknowledges them or when they expire.
- Each repeating alert is tagged
unraid-<server name>, lowercased with dashes. The CLI can stop all of them at once, as long as it uses the same API key as the plugin. - An account can have at most 25 repeating alerts at once. When it is full, or PushWard refuses the acknowledge for another reason, the plugin sends the alert once as an ordinary notification rather than lose it.
pushward receipt cancel --tag unraid-towerHow the button, the repeats and their limits work is covered on the acknowledged alerts page.
End-to-end encryption
With a key set, plugin 2026.10.08 and later encrypt the title, subtitle, body and link of every notification on the Unraid server itself before it is sent. PushWard stores and forwards an envelope it cannot open, and your devices decrypt it with the same key.
- In the PushWard app (1.17.0 or later), open Settings > End-to-End Encryption, create a key and copy it.
- Paste it into End-to-end encryption key and click Apply. The status cards show its Key ID, which should match the one in the app.
The page never shows the stored key: leaving the field empty keeps it, pasting another one replaces it, and Remove key turns encryption off. An hlk_ API key pasted there is refused.
- PushWard can still read the level, the server name, the timestamp and the importance, the name of the Live
Activity a notification links to (such as
tower-array), and the repeat tags when repeating is on, which carry the server name. The event name is not sent readable. Repeats of one event still replace each other's banner because they share an identifier made from it, and from 2026.10.08a that identifier is derived from your encryption key, so it cannot be turned back into the event name. - A link is encrypted only as a full
http://orhttps://address. A link that is a web UI path gets the server's web UI address in front of it (the Unraid web UI URL setting, or the address Unraid detects), and is left out when that is unknown. - The encrypted text has to fit in about 2.2 KB, so a long message is shortened, the body first.
- Live Activities (parity, mover, backups, UPS) and widgets are not encrypted, so the jobs they track are visible to PushWard either way.
- If the key is not valid, or PHP on the Unraid server has no AES-256-GCM, notifications still go out but without their details ("Unraid alert on Tower"). The system log says why, and the encryption card on the Settings tab turns red.
- An API key that belongs to an organization cannot send encrypted notifications. From 2026.10.08a the plugin then sends the alert without its text, as it does for a key that is not valid.
The key is saved with the rest of the settings on the flash drive. What exactly is covered, and what a device without the key shows, is on the end-to-end encryption page.
Logs
tail -f /var/log/pushward-monitor.logThat follows the Live Activity monitor. Notification-delivery problems are logged to the Unraid
system log under the pushward tag.
Updates
The plugin uses a date-based version (e.g. 2026.07.05). Pick up new releases via Plugins → Check for Updates inside Unraid.
Uninstall
Plugins → PushWard → Remove. The agent, monitor, settings and dashboard
pages, and cron are removed, and any active Live Activities are ended. Your config under /boot/config/plugins/pushward-unraid/ is left intact, so reinstalling restores your API
key.