TrueNAS 25.10.3 is Now Available!

The TrueNAS team is pleased to release TrueNAS 25.10.3!

Notable changes:

  • Fixes read authentication errors caused by block cloning between encrypted ZVOLs with different encryption keys (NAS-140263). Block cloning between encrypted ZVOLs that did not share compatible encryption keys was allowed, but subsequent reads of the cloned data produced authentication failures. TrueNAS now verifies that encryption keys match before allowing a block clone operation to proceed.
  • Fixes Active Directory users and groups not found when using the idmap_ad backend with RFC2307 (NAS-140077). The idmap_ad backend failed when smb.conf was configured to disallow a private krb5.conf, preventing Active Directory users and groups from being resolved. Shares and services that depend on directory service identities were inaccessible on affected systems.
  • Fixes pool creation errors on systems with a USB boot drive or other disk with a duplicate serial number (NAS-139947). The disk availability check incorrectly blocked pool creation if any disk on the system had a duplicate serial number, even when that disk was unrelated to the new pool. USB boot drives commonly have blank or duplicate serial numbers and were the most frequent cause. Note that TrueNAS does not recommend USB boot devices. Installing on SATA, SAS, or NVMe flash media is recommended.
  • Fixes issues with log VDEV removal (NAS-140080). Resolves errors that could occur when removing a log VDEV from a storage pool. Affected systems encountered failures during the log VDEV removal process.
  • Fixes link aggregation failover not working out of the box (NAS-136978). Resolves an issue where the MII polling interval was not correctly configured for bonding interfaces using the FAILOVER protocol. The bonding driver could not monitor slave link status, causing failover to fail silently when an interface lost carrier.
  • Fixes Netlink socket errors that caused network interface operations to fail (NAS-140041). Concurrent netlink route operations could collide at the kernel level, producing “Netlink socket busy” (EBUSY) errors. This was most visible as bond status alert failures. The fix serializes netlink route operations to prevent collisions, increases the retry limit, and adds a short delay between retries to reduce the chance of repeated failures.
  • Fixes NTB transport memory allocation failures during link state changes (NAS-139627). Non-Transparent Bridge (NTB) transport memory windows were allocated and freed on every link up/down event. Allocating several megabytes of physically contiguous memory on a running system could fail, causing instability. Memory windows are now pre-allocated at boot, avoiding repeated allocation attempts during link changes. This primarily affects TrueNAS Enterprise High Availability (HA) systems.
  • Fixes stale NFS file handles for ZFS snapshots that could not be recovered without a client reboot (NAS-140474). When mountd failed to resolve a snapshot’s filesystem ID — such as after failover, snapshot expiration, or an automount failure — it permanently cached a negative response, causing all subsequent file handle lookups to return ESTALE errors. Client-side remounts did not clear the cached state. The fix replaces the permanent negative cache with a 120-second retry window, allowing recovery once the snapshot becomes accessible again.
  • Documentation improvement: Adds Drive Health Management documentation covering how TrueNAS 25.10 monitors drive health through ZFS real-time failure detection, automated 90-minute SMART polling, and improved alert filtering. Also covers manual SMART test scheduling options available to TrueNAS Community Edition users. See the Drive Health Management tutorial for full details.

See the Release Notes and changelog for more details.

25.10.3 Documentation : https://www.truenas.com/docs/scale/25.10
Download : https://www.truenas.com/download-truenas-community-edition

Thank you for using TrueNAS! As always, we appreciate your feedback!

12 Likes

Thanks for the hard work!
The backup server just updated without any glitch. Will do my main server tomorrow morning.

4 Likes

Can finally stop getting spammed with Netlink socket busy emails.

3 Likes

Yet another uneventful update… i click udpate, go shower and come back to a working system. I think i’m doing something wrong with this whole homelab thing… nothing ever breaks and it just works :sweat_smile:

5 Likes

For those of us having a hard time finding the URL for 25.10.3:

https://download.sys.truenas.net/TrueNAS-SCALE-Goldeye/25.10.3/TrueNAS-SCALE-25.10.3.iso

2 Likes

I wish that was always the case.

In a previous life, I had a customer do 11 seamless updates on sundays. They were so easy that they moved to 10am on a Monday, didn’t follow instructions carefully, and took a major system down. Always be careful.

1 Like

I had the 25.10.3 release show as an update a couple of hours ago. Came back now to install it, but now showing 26.0.0-BETA.1 as the available update. Going to find the.update file, install 25.10.3 and toggle that switch from “Early Adopter” to “General” I hope.

2 Likes

You won’t be able to do this. In order to set the profile to General you need to be on a release that is currently recommended at least at that level. Currently the latest General release is 25.10.1, so you’d need to be on that version or go to 25.10.3 and wait for it to become General then change your profile.

1 Like

I tested changing the Train in a VM of 25.10.2.1. I booted to 25.10.1 and changed the train to GA but if you have later boot environments your system may still boot to the newer versions and you’re back on EA status. It’s best to remove those later boot environments to insure you stay on GA once you switch.

Updated one system from 25.04.x to 25.10.3, it went fine but I wonder why there is no upgrade zfs pool info or option ?

Also don’t get the profile selection, both seem ambitious :wink:

Is there no conservative profile ?

Developer

Developer software with new features and bugs alike. Allows users to contribute directly to the development process.

Early Adopter

Pre-release access to new features and functionality of TrueNAS software. Some issues may need workarounds, bug reports or patience.

Cheers & Best

1 Like

General is the conservative option but as mentioned 2 posts above:

1 Like

Hi Team,

I have upgrade to 25.10.3 and my UID and GID issue is now resolved, those records are now matching with what we have in AD. Thank you for this critical update.Long live storage freedom!

5 Likes

Aha, What about the zfs pool upgrade or does this happen now automatically since 25.10.x ?

As far as I’ve seen there was no change to the zfs version

1 Like

Don’t upgrade your ZFS pool unless you require new features. It is suggested to upgrade only the features you require and any other dependencies. It is a one way option and earlier version of ZFS will not be able to access the pools after upgrade.

4 Likes

Ahh I thought there was one…ok. thx.

Upgraded and all is running fine. Did notice an anomoly though. When it booted up it spit out this after all of the upgrade..(See attached pic) However, all is running just fine….Weird huh?

1 Like

I had it too regularly with previous versions. It seems to happen randomly after reboots. Sometimes it does, other times it does only shows the main IP.

1 Like

First time i have noticed it. But then i don’t reboot very often.

ZFS pools are never upgraded automatically.
Doing so would prevent the user from downgrading and should it therefore always be initiated by the user only, when they are ready to do so.

3 Likes