Skip to content

feat(plg): stage driver pre-reboot via Unraid os_update event#1

Merged
elibosley merged 1 commit into
mainfrom
os-486-prereboot-os-update-hook
Jun 27, 2026
Merged

feat(plg): stage driver pre-reboot via Unraid os_update event#1
elibosley merged 1 commit into
mainfrom
os-486-prereboot-os-update-hook

Conversation

@elibosley

Copy link
Copy Markdown
Owner

Replaces the per-boot-only download with an event/os_update hook so the rtw88 driver for the incoming kernel is staged during an Unraid OS update, before the reboot prompt — so a reboot never lands on a kernel with no WiFi driver.

How

  • New &emhttp;/event/os_update hook: stages rtw88-<incoming-kernel>.tar.gz (from $3, falling back to parsing /boot/changes.txt), md5-verifies it, prints progress into the Update-OS dialog, and raises an Unraid alert if no build is published.
  • Runs synchronously, so "PLEASE REBOOT" only appears once WiFi is ready.
  • Removed the interim cron guard / pre-reboot-check.sh (never released).

Dependency

Consumer of the generic os_update event added in webgui — Linear OS-486, unraid/webgui#2683. On Unraid releases without that event there is no pre-reboot staging; the boot-time installer fetches the driver after reboot as before (accepted coverage gap for now).

Test

  • xmllint clean; bash -n clean on all resolved blocks.
  • End-to-end sim of the real hook: build-exists → stages + normal notify; no-build → alert, exit 0, no garbage cached; $3 empty → falls back to changes.txt.

Replace the per-boot-only download with an event/os_update hook that fires
during an Unraid OS update, before the reboot prompt, and stages the rtw88
bundle matching the incoming kernel ($3) - so a reboot never lands on a kernel
without a WiFi driver. Alerts if no build is published. Synchronous, so the
update's reboot prompt only appears once WiFi is ready.

Consumer of webgui os_update event (OS-486 / unraid/webgui#2683). On Unraid
releases without the event there is no pre-reboot staging; the boot-time
installer fetches the driver after reboot as before.

Bump to 2026.06.27.3.
@elibosley
elibosley merged commit 2aa78a0 into main Jun 27, 2026
@elibosley
elibosley deleted the os-486-prereboot-os-update-hook branch June 27, 2026 12:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant