Unraid
प्रत्येक Unraid सूचना तुमच्या iPhone वर अग्रेषित करणारे आणि parity तपासण्या, बॅकअप, 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.
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
तुमची डीफॉल्ट hlk_ की शोधण्यासाठी PushWard अॅप उघडा → Settings → Integration Key.
या इंटिग्रेशनसाठी एक समर्पित की तयार करण्यासाठी:
- Settings → Manage Keys वर जा
- + टॅप करा
- नाव सेट करा (उदा. "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.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") | -- |
| 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.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.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.