TrueNAS Quality Lifecycle

Release StageCompleted QA CyclesTypical UseDescription
ALPHA1TestersNot much field testing
BETA2EnthusiastsMajor Feature Complete, but expect some bugs
RC4Home UsersSuitable for non-critical deployments
RELEASE6General UseSuitable for less complex deployments
U17Business UseSuitable for more complex deployments
U2+8Larger SystemsSuitable for higher uptime deployments

June 1, 2021

TrueNAS 12.0-U4 was released today and marks another step forward on the path of improving quality. TrueNAS 12.0-U3.1 has been the highest-ever quality release of the TrueNAS family, is now the most widely deployed version of software, and has been applied to many mission-critical enterprise deployments. TrueNAS 12.0-U4 builds on this foundation and is suitable for conservative users.

TrueNAS 12.0 is the official merger of FreeNAS and TrueNAS into a unified software image accompanied by a long list of features and performance improvements. Nearly all of the significant bugs were resolved in TrueNAS 12.0-U2. With TrueNAS 12.0, OpenZFS 2.0 has outperformed the previous versions of ZFS both in our lab and user environments and has proven to be even more robust in large scale deployments.

TrueNAS 12.0 has reached one exabyte (EiB) of data under management in a little over six months. Over half of the FreeNAS 11.3 installed base have already migrated to TrueNAS CORE and 12.0-U4 makes the process even more compelling and straightforward. Many thanks to the community for making this transition possible.

While releasing TrueNAS 12.0, we created a new lifecycle model for TrueNAS CORE and Enterprise releases. The history of TrueNAS 12.0 releases has been:

  • TrueNAS 12.0 RELEASE was made available October 20, 2020, and included many new features along with OpenZFS 2.0 support.

  • TrueNAS 12.0-U1 was released in December, resolved the most significant bugs, and enabled a few new features like Fusion pools and more efficient scrubbing and resilvering.

  • TrueNAS 12.0-U2 was released in February, and included many bug fixes and some minor features. A minor update to 12.0-U2.1 was provided to reduce some alerts seen by users.

  • TrueNAS 12.0-U3 was released April 13, 2021, and included many bug fixes and some minor features. This release was recommended for mission-critical users. TrueNAS 12.0-U3.1 was launched for security updates.

  • TrueNAS 12.0-U4 was officially released June 1, 2021, and includes some bug fixes and robustness improvements. A full list of changes and bugs is available for those with an account on the TrueNAS Jira bug tracker.

Issues resolved in TrueNAS 12.0-U4:

  • A detailed security scan of 12.0-U4 is also available at the TrueNAS Security site.
  • 18 improvements and 81 bug fixes are included.
  • Python upgrade and several improvements to reduce memory leaks and probability of crashes of core middleware processes. This issue happens rarely, does not impact ongoing data services, and has proven to be difficult to reproduce.
  • OpenZFS improvements for both small and high performance systems. Performance during scrubs while under high CPU load should be more reliable.
  • Security updates for OpenVPN, Samba, and various other ports.
  • Replication webUI improvements to simplify process and avoid mistakes.
  • Updated Minio (the S3 target) to the latest version which includes support for APIv3.
  • Minor webUI and reporting issues including the display of more jails per page.
  • New driver support for Realtek RTL8125/RTL8111 Ethernet devices (2.5GBase-T).

Enterprise customers can contact iX Support for assistance with upgrading their TrueNAS systems.

Contacting iXsystems Support

Customers who purchase iXsystems hardware or that want additional support must have a support contract to use iXsystems Support Services. The TrueNAS Community forums provides free support for users without an iXsystems Support contract.

Contact MethodContact Options
TelephoneMonday - Friday, 6:00AM to 6:00PM Pacific Standard Time:

US-only toll-free: 1-855-473-7449 option 2
Local and international: 1-408-943-4100 option 2
TelephoneAfter Hours (24x7 Gold Level Support only):

US-only toll-free: 1-855-499-5131
International: 1-408-878-3140 (international calling
rates apply)

Please check out the new TrueNAS documentation even if you don’t upgrade today. We’re extremely grateful for all the contributions received thus far and encourage more user suggestions going forward.

TrueNAS 12.0-U4 Changelog


  • [NAS-105205] - Sort order of replication destination dataset list
  • [NAS-105480] - Screen space is not used effectively WebUI (Jails list)
  • [NAS-108091] - Realtek RTL8125/RTL 8111 support
  • [NAS-109450] - Enclosure UI should not require refresh to detect disk status changes
  • [NAS-109955] - Make AD join progress clearer to end-users
  • [NAS-110029] - make public api endpoint for retrieving unique system hash
  • [NAS-110054] - Install Husky and eslint
  • [NAS-110107] - Add dashboard and enclosure management support for TrueNAS-R20A
  • [NAS-110117] - Link Jira ticket in PR when it is created
  • [NAS-110134] - Link to Enclosure Management on Dashboard
  • [NAS-110177] - Add non-invasive linter rules
  • [NAS-110179] - remove grub2 port from MOVED file in ports root
  • [NAS-110198] - Make 12.0-stable branch behave similar to master
  • [NAS-110289] - Use absolute path for imports in VSCode
  • [NAS-110328] - Refactor DialogService
  • [NAS-110331] - Simplify translation system
  • [NAS-110471] - Improve type safety of ws calls
  • [NAS-110546] - Support URLs in setup_env.js

Bug Fixes

  • [NAS-107364] - Scrub causes system "catatonic", apparently due to extreme CPU starvation
  • [NAS-107676] - enabling lockd debugging raises CallTimeout when restarting nfsd
  • [NAS-108044] - Unable to generate debug file
  • [NAS-108370] - Transfers fail with krb5i
  • [NAS-108847] - repeated POLLHUP on zfsd
  • [NAS-108995] - Make WebUI builds reproducible
  • [NAS-109033] - Error while importing certificates
  • [NAS-109388] - disk.get_unused isn't returning a complete list
  • [NAS-109397] - Failed to connect to RRDCacheD
  • [NAS-109522] - Can't reconfigure S3 AkSk on the same dataset
  • [NAS-109545] - Slow (iSCSI) api
  • [NAS-109635] - smbd.core file found while moving files between 2 shares
  • [NAS-109664] - UI components should avoid redundant disk.query event subscriptions
  • [NAS-109672] - Scheduler preview not handling daylight savings time correctly
  • [NAS-109696] - Cloud Sync Task Dropbox never completes, stuck at 100%
  • [NAS-109720] - Interrupted full replications are silently failing to resume
  • [NAS-109755] - Stray question mark in "Restart SMB Service" button string
  • [NAS-109756] - Filtered SMB share list does no refresh after deleting a share
  • [NAS-109769] - HA journal EOFError pickle.load()
  • [NAS-109778] - Unable to delete a corrupt jail NAS-109776
  • [NAS-109799] - Some Text In UI (Storage > Pools > Edit ACL) don't show up in the .PO file
  • [NAS-109803] - SMB User/Group not showing up correctly in Windows clients after updating TrueNAS netbios name
  • [NAS-109828] - SNMP UCD-SNMP-MIB Counter64 wrap at 32bit values
  • [NAS-109830] - Middleware error on cloudsync
  • [NAS-109831] - Task manager shows vmware.periodic_snapshot_task_begin every 10 minutes
  • [NAS-109837] - TrueNAS 12.0 U2.1 Cant install Plugin / Jail -- DNS Error
  • [NAS-109846] - failover taking 6hrs to complete on 12.0-U2.1
  • [NAS-109849] - failover log spam
  • [NAS-109885] - Alert Message to submit ticket
  • [NAS-109903] - Wrong openapi schema on {id} endpoints
  • [NAS-109907] - TrueCommand Cloud cannot access added systems if they have the Listen Interface customized
  • [NAS-109910] - Add unique constraints
  • [NAS-109912] - ZFS checksum errors with PMC8003/pms(4)
  • [NAS-109928] - Replication failed (ZFS snap) after last upgrade
  • [NAS-109932] - Properly show error messages for invalid client cert
  • [NAS-109959] - Fix AD cache fill with alternate character sets
  • [NAS-109967] - Add tests for ZFS quotas through SMB proto
  • [NAS-109971] - Replication error inconsistent display
  • [NAS-109972] - zettarepl.datasets_have_encryption is always called with recursive=true
  • [NAS-109976] - Changes in debug generation process
  • [NAS-109979] - replications of zvol fails
  • [NAS-109989] - [EFAULT] LDAP cache already exists. Refusing to generate cache
  • [NAS-109993] - Fix spacing and border color on dark themes
  • [NAS-110000] - zfsd crash on device detach
  • [NAS-110038] - Replication of dataset fails after big deletion on the source
  • [NAS-110097] - netcli doesnt generate carp password on HA systems
  • [NAS-110133] - Do not show a successful status for cloud sync that was not executed …
  • [NAS-110140] - upgrade to python 3.9 in 12.0-U4
  • [NAS-110162] - s3:modules:ixnas - fix regression in base user quota
  • [NAS-110171] - Two dashboard widgets hanging after update to 12.0-U3
  • [NAS-110174] - SSH alerts even though SSH service is disabled
  • [NAS-110201] - clearing old core files crashes
  • [NAS-110214] - After upgrade to 12.0-U3, at boot no active network.
  • [NAS-110234] - All replication hangs until system reboot, again, after SSHException
  • [NAS-110240] - Not showing temps for hdd
  • [NAS-110243] - GET /api/v2.0/system/general/ui_restart fails with 405: Method Not Allowed
  • [NAS-110244] - Snapshot Lifetime help text contradicts default value
  • [NAS-110246] - Pools > Edit Zvol fields show incorrect data or not populated
  • [NAS-110247] - Missing "Force HDD standby" in SMART prevent drives to go to sleep
  • [NAS-110258] - net/samba - tevent_kqueue - reduce logging
  • [NAS-110259] - Disable sentry if middlewared code is an NFS mount
  • [NAS-110294] - nmbd core dump
  • [NAS-110311] - core dump at smb
  • [NAS-110317] - Fix retention shells
  • [NAS-110351] - mpr(4): corrupted DPM recovery
  • [NAS-110362] - TypeError "cannot convert 'int' object to bytes" when enabling SSSD Compatibility in AD Idmap
  • [NAS-110433] - xmrig plugin breaks mdns responder
  • [NAS-110448] - Update Minio to API v3 compatible release
  • [NAS-110461] - net/samba - update to Samba 4.12.15
  • [NAS-110465] - OpenVPN CVE-2020-15078
  • [NAS-110474] - Dashboard CSS bugs in Firefox 88
  • [NAS-110478] - Clicking on "Storage" from the side menu does nothing. Can't access Storage page
  • [NAS-110503] - Wrong Selection of drive
  • [NAS-110505] - SMART test results, spinning circle with no results
  • [NAS-110509] - Error when test run
  • [NAS-110575] - Wireguard Tunnel remains on passive node of HA system after failover.
  • [NAS-110596] - net/samba - handle EINTR properly in tevent_kqueue
  • [NAS-110598] - Fix a few python ports for new python extension format
  • [NAS-110606] - Update zettarepl port
  • [NAS-110607] - Fix (almost all) unit test failures
  • [NAS-110714] - fix memory allocation/leak in multipath.query()

Known Issues

NAS-111220Enclosure management mapping may not work properly for TrueNAS R-SeriesThis issue will be fixed with the 12.0-U5 Release.
NAS-1098422FA authentication missing for enterpriseUse the following CLI instructions for the workaround:
  • Add Secret Key to authenticator: midclt call auth.twofactor.config {"id": 1, "otp_digits": 6, "secret": "3FVIQJ6ESUVRLRXR", "window": 0, "interval": 30,"services": \{"ssh": false}, "enabled": false}
  • Enable 2FA Service: midclt call auth.twofactor.update '{"enabled": true}'
NAS-110785Inherit option overriding encryption on dataset creationWhen creating the dataset uncheck inherit encyryption first, then uncheck encryption before saving. If you uncheck encryption first it will prevent inherit encryption from being displayed and inherit encryption will silently remain enabled.
NAS-109522Starting the S3 Service removes the Minio Configuration DirectoryUsers need to be aware that custom changes made in the minio configuration directory are removed every time the service is started.
NAS-106992Persistent L2ARC is disabled by default.While the underlying issues have been fixed, this setting continues to be disabled by default for additional performance investigation. To manually reactivate persistent L2ARC, log in to the TrueNAS Web Interface, go to System > Tunables, and add a new tunable with these values:
  • Type = sysctl
  • Variable = vfs.zfs.l2arc.rebuild_enabled
  • Value = 1
TrueNAS "root" user account cannot be an SMB user.This is an intentional change to improve software security and suitability for deployment in a variety of environments. Update the SMB configuration to use a different user account.