You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Purpose: update the Unraid OS 7.3.0 release notes from the release-candidate draft to the stable release changelog.
- Before: the page described 7.3.0-rc.2, included pre-release guidance, and compared changes against the earlier pre-release baseline.
- Problem: users landing on the release notes after the stable release would see outdated release-candidate status and incomplete stable release details.
- Now: the page is marked as Version 7.3.0 released 2026-05-12 and includes the stable known issues, rollback guidance, feature sections, and package update lists.
- How: sourced the formatted release-note content from Linear, normalized links and Markdown for Docusaurus, and kept validation limited to targeted Markdown checks.
Copy file name to clipboardExpand all lines: docs/unraid-os/release-notes/7.3.0.md
+33-96Lines changed: 33 additions & 96 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,28 +1,26 @@
1
-
# Version 7.3.0-rc.2 2026-05-06
1
+
# Version 7.3.0 2026-05-12
2
2
3
-
This release candidate builds on 7.3.0-rc.1 with targeted fixes for internal boot, ZFS pool replacement workflows, virtualization, Docker, TPM-based licensing, WebGUI security hardening, and other miscellaneous bug fixes.
4
-
5
-
This is RELEASE CANDIDATE software. Please use on test servers only.
3
+
This stable release adds internal boot support, an onboarding wizard, TPM-based licensing, Docker networking improvements, expanded hardware support, ZFS and storage fixes, virtualization updates, WebGUI security hardening, and package updates.
6
4
7
5
## Upgrading
8
6
9
7
For step-by-step instructions, see [Updating Unraid](/unraid-os/updating-unraid/). Questions about your [license](/unraid-os/troubleshooting/licensing-faq/)?
10
8
11
9
### Known issues
12
10
13
-
See [Unraid OS Pre-release (Bugs & Feedback)](https://product.unraid.net/b/unraid-os-prerelease-bugs-feedback) for issues reported by other testers.
14
-
15
11
- 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.
16
12
- Internal boot requires boot storage that can be accessed by built-in Linux drivers during startup. Devices that require third-party drivers or post-boot configuration cannot be used for internal boot. Unraid supports the following drivers for internal boot:
17
-
- mvsas (rc.2)
18
-
- mpt3sas
19
-
- smartpqi (rc.2)
20
-
- nvme
21
13
- ahci
22
14
- mmc
15
+
- mpt3sas
16
+
- mvsas
17
+
- nvme
18
+
- smartpqi
23
19
- USB (`usb-storage` and `uas`, also known as UASP)
24
-
-Some invalid ZFS pool names that begin with reserved ZFS prefixes may fail without a clear WebGUI error. Choose a different pool name if creation does not complete.
20
+
-If a dual-device boot pool contains a device with an unformatted data partition, removing one boot-pool device may not complete correctly.
25
21
- If a split boot-pool device is removed and another device is added immediately afterward, the slot count may not always update until the server is rebooted.
22
+
- Some UPS devices may report **Online No battery detected** and log repeated `Event data for report 22 was too short` messages. If affected, the NUT plugin may provide a working UPS monitoring path.
23
+
- Some Docker containers on VLAN networks may fail to receive DHCP or use the expected static network configuration after upgrading from 7.2.4 or 7.2.5. This is still under investigation.
26
24
27
25
### Notes
28
26
@@ -31,96 +29,40 @@ See [Unraid OS Pre-release (Bugs & Feedback)](https://product.unraid.net/b/unrai
31
29
32
30
### Rolling back
33
31
34
-
- 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-rc.1` without issue.
35
-
- Do not roll back to `7.2.5` or earlier after enabling internal boot or TPM-based licensing.
32
+
- Do not roll back to `7.2.6` or earlier after enabling internal boot or TPM-based licensing.
36
33
- If you upgrade ZFS pool features, earlier Unraid releases may not be able to import those pools.
37
-
- If you need to roll back, follow the normal pre-release rollback process before moving between builds.
38
-
39
-
If you are considering any rollback path below `7.3.0-rc.1`, also see the [7.2.4 release notes](/unraid-os/release-notes/7.2.4/).
34
+
- If you need to roll back, follow the normal rollback process before moving between builds.
40
35
41
-
## Changes from 7.3.0-rc.1
36
+
If you are considering any rollback path below `7.3.0`, also see the [7.2.6 release notes](/unraid-os/release-notes/7.2.6/).
42
37
43
-
Only the items in this section are new or materially updated in rc.2. Broader changes from 7.2.5 are included below.
38
+
## Changes vs. [7.2.6](/unraid-os/release-notes/7.2.6/)
44
39
45
40
### Security
46
41
47
-
- Security: Add WebGUI security hardening for authenticated-session request handling. Upgrade recommended. This security fix is also present in 7.2.5.
48
-
- Security note: The included 7.3 kernel already contains the fix for CVE-2026-31431, the Copy Fail local privilege escalation vulnerability. This security fix is also present in 7.2.5.
49
-
50
-
### Licensing
51
-
52
-
- Fix: Improve TPM-based license replacement blacklist handling so a transferred TPM-based key is blocked without permanently blocking the underlying motherboard GUID from future valid activation.
53
-
54
-
### Containers / Docker
55
-
56
-
- Improvement: Update Docker to version `29.4.1`.
57
-
58
-
### Storage
59
-
60
-
- New: Add mvsas and smartpqi as built-in storage drivers so they can be used for internal boot.
61
-
- Fix: Address an md/unraid driver crash.
62
-
- Fix: Correct ZFS pool replacement handling when a dropped device is marked `REMOVED`, so replacement workflows no longer leave the pool degraded with a stale blue new-device state or repeated overwrite warning.
63
-
- Fix: Improve dedicated and split boot-pool detection after boot-pool devices are replaced with larger devices.
64
-
- Fix: Allow adding a device to a formatted split boot pool when the data partition is formatted as ZFS or BTRFS.
65
-
- Fix: Prevent creation of ZFS pools whose names start with reserved ZFS name prefixes: `mirror`, `raidz`, `draid`, and `spare`.
66
-
67
-
### WebGUI / System
68
-
69
-
- New: Show chassis serial number in System Info when a valid chassis serial is available.
70
-
- Fix: Keep the WebGUI responsive while adding Docker containers from the Add Container page.
71
-
- Fix: Correct stale status display after affected storage replacement workflows.
72
-
- Fix: Use online / offline instead of on-line / off-line in various text.
73
-
74
-
### Virtualization
75
-
76
-
- Fix: Update deprecated VM machine types during startup so older VMs do not fail with unsupported QEMU machine-type errors after upgrading.
77
-
- Fix: Show the assigned `RenderGPU` for the first VM in the VM list when using Virtio 3D.
78
-
79
-
## Changes vs. [7.2.5](/unraid-os/release-notes/7.2.5/)
80
-
81
-
### Security
82
-
83
-
- Security: Add WebGUI security hardening for authenticated-session request handling. Upgrade recommended.
84
-
- Security: Update `bind` from `9.20.13` to `9.20.20`.
85
-
- Security note: The included 7.3 kernel contains the fix for CVE-2026-31431, the Copy Fail local privilege escalation vulnerability.
42
+
- Security: Add WebGUI security hardening for authenticated-session request handling. This fix is already included in 7.2.5.
43
+
- Security: Update packages
44
+
- Security note: The included 7.3 kernel contains the fix for CVE-2026-31431, the Copy Fail local privilege escalation vulnerability as well as CVE-2025-43284 Dirty Frag local privilege escalation vulnerability.
86
45
87
46
### Onboarding and internal boot
88
47
89
48
New users automatically start in the onboarding wizard, where they choose language, time zone, theme, activation code settings, and boot option, including internal boot.
90
49
91
-
Existing users can go to **_Settings → Onboarding Wizard_** to review settings and migrate to internal boot.
50
+
Existing users can go to **_Tools → Onboarding Wizard_** to review settings and migrate to internal boot.
92
51
93
52
For details, see [Onboarding](/unraid-os/getting-started/set-up-unraid/deploy-and-configure-unraid-os/).
94
53
95
-
- New: Add dedicated boot pool support as a distinct option from split boot pools.
96
-
- Improvement: Move the Onboarding Wizard under Tools and add a direct internal-boot device link when setup still needs attention.
97
-
- Improvement: Update many user-facing strings from "Flash" to "Boot".
98
-
- Improvement: Improve organization of boot-related settings.
99
-
- Fix: Force the expected reboot or shutdown flow after internal boot setup.
100
-
- Fix: Restore the Boot page browse icon on affected systems.
101
-
- Fix: Correct black-theme dropdown visibility in the Onboarding Wizard.
102
-
- Fix: Correct the GMT time zone selection state in the Onboarding Wizard.
103
-
- Fix: Correct the New Config tool so it handles boot pools properly.
104
-
- Fix: Allow pools that were previously configured as boot pools to be removed correctly.
105
-
- Fix: Keep the boot pool visible when an expected boot-pool disk is missing or a wrong disk is selected.
106
-
- Fix: Improve dedicated and split boot-pool detection after boot-pool devices are replaced with larger devices.
107
-
108
54
### Licensing
109
55
110
56
All new and replacement keys use TPM-based licensing when possible because it is more reliable than flash-based licensing.
111
57
112
58
To proactively switch to TPM-based licensing, see [How can I move from flash-based licensing to TPM-based licensing](/unraid-os/troubleshooting/tpm-licensing-faq/#tpm).
113
59
114
-
- Improvement: Improve handling of missing key file states.
115
-
- Fix: Improve TPM-based license replacement blacklist handling so a transferred TPM-based key is blocked without permanently blocking the underlying motherboard GUID from future valid activation.
116
-
117
60
### Containers / Docker
118
61
119
-
- Improvement: Update Docker from `29.3.1` to `29.4.1`.
62
+
- Improvement: Update Docker from `29.3.1` to `29.4.3`.
120
63
- 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.
121
64
- Improvement: Show Docker container MAC addresses in Advanced View alongside existing network and IP information.
122
65
- 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.
123
-
- 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.
124
66
- Fix: Add the missing support needed for Strix Point iGPU Docker workloads on affected systems. See the [user report](https://product.unraid.net/p/strix-point-igpu-support).
125
67
- Fix: Keep the WebGUI responsive while adding Docker containers from the Add Container page.
126
68
@@ -130,32 +72,26 @@ To proactively switch to TPM-based licensing, see [How can I move from flash-bas
130
72
- 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.
131
73
- Improvement: Improve visibility into pool and drive health information.
132
74
- Improvement: Improve duplicate drive detection and related messaging.
133
-
- Fix: Address sector-size compatibility regressions for 4Kn devices and some LSI HBA setups using 512e disks that affect XFS-formatted array disks.
134
-
- Fix: Address an md/unraid driver crash that could make encrypted XFS array disks report a missing or wrong encryption key when affected systems used 4Kn parity.
135
-
- 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.
136
75
- Fix: Prevent drives from spinning down during parity copy as part of parity swap.
137
76
- Fix: Correct ZFS pools waking once every 24 hours in affected cases.
138
-
- 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`.
139
77
- Fix: Correct ZFS pool replacement handling when a dropped device is marked `REMOVED`, so replacement workflows no longer leave the pool degraded with a stale blue new-device state or repeated overwrite warning.
140
-
- Fix: Allow adding a device to a formatted split boot pool when the data partition is formatted as ZFS or BTRFS.
141
-
- Fix: Prevent creation of ZFS pools whose names use reserved ZFS name prefixes such as `mirror`, `raidz`, `raidz1`, `raidz2`, `raidz3`, or `spare`.
78
+
- Fix: Prevent creation of ZFS pools whose names use reserved ZFS name prefixes such as `mirror`, `raidz`, `draid`, or `spare`.
142
79
143
80
### WebGUI / System
144
81
145
82
- Improvement: Refresh WebGUI and system-device workflows for the 7.3 internal-boot and hardware-support work.
146
83
- Improvement: Add support for the Cooler Master Qube 500 case model.
147
84
- New: Show chassis serial number in System Info when a valid chassis serial is available.
148
-
-Fix: Handle CRLF line endings in Syslinux and GRUB configuration files so the Boot Parameters page can read settings edited from Windows.
85
+
-Improvement: Show a clearer licensing status message when no valid TPM or flash licensing device is detected.
149
86
- Fix: Correct RAM display parsing after dmidecode unit label changes.
150
87
- Fix: Correct time zone label and identifier issues in affected regions.
151
-
- Fix: Restore the `Bind selected to vfio` action in System Devices on affected setups.
152
88
- Fix: Stop WebGUI and API requests from spinning up the full HDD array on affected systems.
153
-
- Fix: Restore CPU isolation saving so selected cores apply correctly again.
154
89
- Fix: Persist the built-in `rclone` configuration in a persistent location across reboot.
155
90
- Fix: Correct strict proxy connectivity checks when using HTTP proxies that block CONNECT on port 80.
0 commit comments