Unraid

모든 Unraid 알림을 iPhone으로 전달하고 패리티 검사, 백업, mover, UPS 이벤트를 Lock Screen에 Live Activities로 표시하는 네이티브 Unraid 플러그인입니다.

ℹ 정보

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 앱을 열고 → 설정 → 연동 키에서 기본 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.