1 December 2023

Unraid 6.12.6 Now Available

Unraid OS Version 6.12.6 is now available. This release reverts the ZFS bug mitigation from 6.12.5 and replaces it with the actual fix released by the OpenZFS team less than 18 hours ago. There are also some IPv6 fixes.

6 12 stable 7 b8a4e700e202fbc0589cab4c9ca90d8d

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

Unraid 6.12.6 Links

Comment on the release, report bugs and check out our docs

Img Pricing 1

Pricing

With affordable options starting at just $49, we have a license for everyone.

Img Trial 2024 02 08 212340 axtg

Try before you buy

Not sure if Unraid is right for you? Take Unraid for a test drive for 30 days—no credit card required.