December 01, 2023 Releases

Unraid 6.12.6 Now Available

6 12 stable 7

The OpenZFS team has published a true fix (rather than just a mitigation) for the ZFS data corruption issue, so we are publishing Unraid 6.12.6 with that fix.

This release also includes an IPv6 bug fix.

All users are encouraged to read the release notes and upgrade.

Upgrade Notes

Known issues

Out of date plugins
Out of date plugins can cause problems, we recommend they be kept current.

Call traces and crashes related to macvlan

If you are getting call traces related to macvlan (or any unexplained crashes, really), as a first step, we'd recommend navigating to Settings > Docker, switching to advanced view, and changing the Docker custom network type from macvlan to ipvlan. This is the default configuration that Unraid has shipped with since version 6.11.5 and should work for most systems. Note that some users have reported issues with port forwarding from certain routers (Fritzbox) and reduced functionality with advanced network management tools (Ubiquity) when in ipvlan mode. If this affects you, see the alterate solution available since Unraid 6.12.4.

Network problems due to jumbo frames

If you are having network issues, confirm that you haven't enabled jumbo frames.
Navigate to Settings > Network Settings > eth0 and confirm the Desired MTU is 1500. For more information, see the Fix Common Problems warning for jumbo frames.

Problems due to Realtek network cards

Stock Realtek drivers in the latest Linux kernels are causing network and stability issues. If you are having issues and Tools > System Devices shows that you have a Realtek ethernet controller, grab the part number shown and search Community Apps to see if there is a Realtek driver plugin for that device. For more information, see the support page for Realtek driver plugins.

Adaptec 7 Series HBA not compatible

If you have an Adaptec 7 Series HBA that uses the aacraid driver, we'd recommend staying on 6.12.4 for now as there is a regression in the driver in the latest kernels. For more information see this bug report in the Linux kernel

Other issues?

We highly recommend installing the Fix Common Problems plugin as it will warn you of common configuration problems.
Have other crashes or stability issues? Navigate to Settings > Syslog Server and enable Mirror syslog to flash. This will cause additional wear and tear on the flash drive but is useful in the short term for gathering logs after a crash. After the next reboot, navigate to Tools > Diagnostics and download your anonymized diagnostics (as of 6.12.5, diagnostics automatically include logs that were mirrored to the flash drive). Then start a new topic under General Support and provide all the details of the issue. Once the issue is resolved, be sure to disable Mirror syslog to flash.

Please see the 6.12.0 release notes for general known issues.

Rolling back

If rolling back earlier than 6.12.4, also see the 6.12.4 release notes.

Need an Unraid Easy Button?

We now offer custom, 1-on-1 support with Unraid experts in the English, French, and Spanish languages.

Changes vs. 6.12.5

Bug Fixes and Improvements

  • modprobe.d/zfs.conf: remove zfs_dmu_offset_next_sync=0 mitigation - no longer needed
  • network: Fix IPv6 static address assignment

Package Updates

  • nvme-cli: version 2.6
  • zfs: version 2.1.14

Linux kernel

  • version 6.1.64

Got Bugs?

If you discover a bug or other issue in this release, please open a Stable Releases Bug Report and include your system diagnostics.

Forum Release Announcement

Please check out our friendly forums for general comments and quick questions.