Skip to main content

Version 7.3.0-rc.1 2026-04-22

This release candidate includes onboarding and internal boot, TPM-based licensing, Docker and storage improvements, WebGUI improvements, virtualization updates, hardware support, and platform package updates.

This is RELEASE CANDIDATE software. Please use on test servers only.

Curious about what our different release types are? See Unraid OS release types.

Upgrading​

For step-by-step instructions, see Updating Unraid. Questions about your license?

Known issues​

See Unraid OS Pre-release (Bugs & Feedback) for issues reported by other testers.

  • During internal boot setup, the WebGUI may show Array Offline while internal boot configures. DO NOT manually restart or remove your flash drive during this process.
  • Internal boot requires boot storage that can be accessed by in-tree Linux drivers during startup. Devices that require third-party drivers or post-boot configuration cannot be used for internal boot.

Notes​

  • Adding, removing, and replacing devices in the ZFS boot pool generally works correctly. One exception: if you start with a dedicated boot pool made from two small devices and replace them one at a time with larger devices, the pool may convert to a split pool.
  • When boot-pool devices are added, removed, or replaced, Unraid does not currently update the server BIOS boot priority automatically. After making those changes, verify the BIOS boot order manually.

Rolling back​

  • If you already enabled internal boot or switched to TPM-based licensing while testing the 7.3 pre-release, you can roll back to 7.3.0-beta.1 without issue.
  • Do not roll back to 7.2.4 or earlier after enabling internal boot or TPM-based licensing.
  • If you upgrade ZFS pool features, earlier Unraid releases may not be able to import those pools.
  • If you need to roll back, follow the normal pre-release rollback process before moving between builds.

If you are considering any rollback path below 7.3.0-beta.1, also see the 7.2.4 release notes.

Changes vs. 7.2.4​

Security​

Update bind to fix outstanding CVEs.

Onboarding and internal boot​

New users automatically start in the onboarding wizard, where they choose language, time zone, theme, activation code settings, and boot option, including internal boot.

Existing users can go to Settings → Onboarding Wizard to review settings and migrate to internal boot.

For details, see Onboarding.

  • New: Add dedicated boot pool support as a distinct option from split boot pools.
  • Improvement: Move the Onboarding Wizard under Tools and add a direct internal-boot device link when setup still needs attention.
  • Improvement: Update many user-facing strings from "Flash" to "Boot".
  • Improvement: Improve organization of boot-related settings.
  • Fix: Force the expected reboot or shutdown flow after internal boot setup.
  • Fix: Restore the Boot page browse icon on affected systems.
  • Fix: Correct black-theme dropdown visibility in the Onboarding Wizard.
  • Fix: Correct the GMT time zone selection state in the Onboarding Wizard.
  • Fix: Correct the New Config tool so it handles boot pools properly.
  • Fix: Allow pools that were previously configured as boot pools to be removed correctly.
  • Fix: Keep the boot pool visible when an expected boot-pool disk is missing or a wrong disk is selected.

Licensing​

All new and replacement keys use TPM-based licensing when possible because it is more reliable than flash-based licensing.

To proactively switch to TPM-based licensing, see How can I move from flash-based licensing to TPM-based licensing.

  • Improvement: Improve handling of missing key file states.

Containers / Docker​

**Important: Docker has been updated from v27 (in 7.2.4) to v29. This changes how MAC addresses are allocated to containers and randomizes them. **

  • Improvement: Update Docker to 29.3.1.
  • New: Add an optional fixed MAC address field to Docker templates for containers that need a stable network identity across restarts, including DHCP reservations, router or firewall rules, switch ACLs, and monitoring.
  • Improvement: Show Docker container MAC addresses in Advanced View alongside existing network and IP information.
  • Fix: Migrate legacy --mac-address= values from Extra Parameters into the new fixed MAC field where safe, while leaving templates unchanged when networking is still owned by Extra Parameters.
  • Fix: Prevent duplicate Docker user templates when container names and template filenames differ only by case on case-sensitive boot storage, such as ZFS internal boot.
  • Fix: Hide stale dead or uninspectable "phantom" containers that became newly visible after the Docker 27 to 29 upgrade path. This filters confusing leftovers out of the WebGUI without mutating Docker state. Background: Docker 29 release notes.
  • Fix: Add the missing support needed for Strix Point iGPU Docker workloads on affected systems. See the user report.
  • Fix: Prevent VMs created from user-defined templates from inheriting the source VM MAC address.

Storage​

  • New: Show corrupted files in ZFS pool status.
  • New: Add user-facing control for ZFS ARC max size on Settings → Disk Settings → Tunable (zfs_arc_max). This used to be controlled through a custom ZFS driver parameter. You may need to migrate your setting to the new location.
  • Improvement: Improve visibility into pool and drive health information.
  • Improvement: Improve duplicate drive detection and related messaging.
  • Fix: Address sector-size compatibility regressions for 4Kn devices and some LSI HBA setups using 512e disks that affect XFS-formatted array disks.
  • Fix: 4Kn devices formatted XFS with 7.3.0-beta.1 or newer can now be moved out of the array and mounted normally in pools or other Linux systems. Older XFS filesystems that were formatted inside the array on 4Kn disks in previous Unraid releases still cannot be corrected without reformatting.
  • Fix: Prevent drives from spinning down during parity copy as part of parity swap.
  • Fix: Correct mover availability when emptying an array disk with no pool assigned.
  • Fix: Correct ZFS pools waking once every 24 hours in affected cases.
  • Fix: Correct pool-device detection for larger device names, including devices such as sdp and sdap, so affected pool disks no longer appear as Unknown.

WebGUI / System​

  • Improvement: Refresh WebGUI and system-device workflows for the 7.3 internal-boot and hardware-support work.
  • Improvement: Add support for the Cooler Master Qube 500 case model.
  • Fix: Handle CRLF line endings in Syslinux and GRUB configuration files so the Boot Parameters page can read settings edited from Windows.
  • Fix: Correct File Manager styling on the Main tab so it follows the selected theme.
  • Fix: Correct RAM display parsing after dmidecode unit label changes.
  • Fix: Correct time zone label and identifier issues in affected regions.
  • Fix: Restore the Bind selected to vfio action in System Devices on affected setups.
  • Fix: Stop WebGUI and API requests from spinning up the full HDD array on affected systems.
  • Fix: Restore CPU isolation saving so selected cores apply correctly again.
  • Fix: Persist the built-in rclone configuration in a persistent location across reboot.
  • Fix: Correct strict proxy connectivity checks when using HTTP proxies that block CONNECT on port 80.
  • Fix: Correct rc.crond status typo.
  • Fix: Auto-restart SSH daemon after network recovery.
  • Fix: Correct Discord notification formatting issues.
  • Fix: Correct interface parsing when ip addr output includes peer information.
  • Fix: Correct custom image case model handling on the login page.
  • Fix: Remove outdated ReiserFS warnings and stale references.

File Manager​

  • Improvement: Improve File Manager UI and overall performance.
  • Improvement: Improve same-filesystem move operations.
  • Improvement: Improve upload behavior.
  • Fix: Correct path handling issues involving /sub/ in file paths.
  • Fix: Correct scrollbar interaction issues during copy or move operations.
  • Fix: Correct handling of double quotes in directory names.
  • Fix: Correct move and rename edge cases.
  • Fix: Preserve empty directories during affected rename operations.

Networking / Hardware​

  • Improvement: Update kernel config for additional AMD XDNA and ACP support, including CONFIG_DRM_ACCEL_AMDXDNA, CONFIG_DRM_AMD_ACP, CONFIG_REMOTEPROC, generic power-domain support, and CONFIG_REMOTEPROC_CDEV.
  • Improvement: Add AMD NPU firmware, Intel Bluetooth firmware, Intel wireless firmware, and the amdxdna kernel module.
  • New: Add Settings → Tailscale stub page for easier plugin discovery.

Virtualization​

  • Improvement: Improve System Devices visibility and VM template workflows.
  • Improvement: Improve custom VNC port validation and defaults.
  • Improvement: Update QEMU to 10.2.2, libvirt to 12.2.0, and refresh the OVMF firmware package.
  • Fix: Address virtiofs hangs seen with affected Linux guests.
  • Fix: Correct VM snapshot commit cleanup not updating snapshot metadata correctly.
  • Fix: Correct libvirt startup issues encountered during testing.

Unraid API​

Linux kernel​

  • Linux kernel: version 6.18.23-Unraid

Base distro updates​

  • bind: version 9.20.20
  • btrfs-progs: version 6.19
  • docker: version 29.3.1
  • glib2: version 2.86.4
  • gtk+3: version 3.24.51
  • libvirt: version 12.2.0
  • mesa: version 26.0.1
  • nfs-utils: version 2.8.5
  • qemu: version 10.2.2
  • xfsprogs: version 6.18.0
  • zfs: version 2.4.1

Pre-release tester notes​

CHANGES FROM BETA.2​

  • Docker template MAC handling now has a dedicated fixed MAC field and shows live MAC addresses in Advanced View.
  • Docker template lookup now handles case-only filename differences on case-sensitive boot storage.
  • Boot pool and pool-device display fixes for missing, wrong, or larger device names.
  • CRLF handling for Syslinux and GRUB configuration files.
  • File Manager theme fix on the Main tab.
  • QEMU 10.2.2, libvirt 12.2.0, refreshed OVMF firmware, and a virtiofs hang fix.
  • dynamix.unraid.net 4.32.3.