Unraid

一個原生 Unraid 外掛程式，可將每則 Unraid 通知轉發到您的 iPhone，並在您的 Lock Screen 上以 Live Activities 的形式顯示同位檢查、備份、mover 與 UPS 事件。

ℹ 資訊

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. ALERT and WARNING map to active iOS pushes, everything else to passive (turn on INFO too 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 App → 設定 → 整合金鑰，即可找到您的預設 hlk_ 金鑰。

若要為此整合建立專屬金鑰：

前往 設定 → 管理金鑰
點按 +
設定名稱（例如「Unraid」），選擇 , 完整管理 範圍，並限定於unraid-*
複製產生的 hlk_ 金鑰

One hlk_ key covers both features. Notifications need the notifications capability and work on any plan; Live Activities need the activity:manage scope 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.plg

Unraid 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")	--
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`

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.

Logs

tail -f /var/log/pushward-monitor.log

That 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.06.26). 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.