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

15 September 2020

iXsystems is pleased to announce the general availability of TrueNAS 12.0 Release Candidate 1! This is the first release candidate for the first unified FreeNAS and TrueNAS release, renamed to TrueNAS CORE and TrueNAS Enterprise, respectively. More than 180 bugs have been fixed since 12.0-BETA2 as final polishing continues toward the launch of 12.0-RELEASE in October.

TrueNAS 12.0

The TrueNAS 12.0 release is a major new update to the TrueNAS family of storage products. TrueNAS CORE is the successor to FreeNAS, which is still fully open-source and offering the same functionality and more features than ever before. Included in version 12 are major changes to the ZFS filesystem, bringing all upcoming OpenZFS 2.0 (Formerly ZFS on Linux). Additionally, version 12 includes these notable changes and improvements:

  • ZFS Native Crypto - Per-dataset encryption and support for encrypted replication to untrusted targets.
  • 2 Factor Authentication - Allows using Applications such as “Google Authenticator” to provide an extra level of security before logging into the UI or SSH access.
  • KMIP Support - TrueNAS Enterprise now adds the ability to interface with KMIP servers for the storage and retrieval of passwords and encryption keys.
  • Performance Improvements - Virtually every area of the platform has been updated and includes some major performance improvements, including SMB, iSCSI, ZFS and more.
  • API Keys - All of TrueNAS can be configured with TrueNAS API v2.0 and now supports API keys for remote access. The v1.0 API is no longer supported.
  • Fusion Pools - Allows creating pools with all-flash vdevs that store metadata and small-block IO. This provides flash-like performance on all metadata operations, but with the cost effectiveness of spinning disk for storage blocks.
  • VPN Support - Support for TrueNAS acting as both an OpenVPN Server and Client, depending on your VPN needs.
  • TrueCommand Cloud Integration - TrueNAS 12.0 systems can be connected directly to a TrueCommand Cloud account for scaled monitoring and management of your TrueNAS systems - no additional hardware needed! For Early Access to TrueCommand Cloud, go to portal.ixsystems.com and create an iX account, then send an email to truecommand-sales@ixsystems.com to request Early Access to the TrueCommand Cloud Services. Be sure to include the email address that you used to create your iX Account.

The Docs Hub has step-by-step instructions for configuring TrueCommand Cloud.

These major changes are also paired with numerous other bug fixes and quality-of-life type improvements to the UI and APIs for users. We’ve also revamped our Documentation, focusing more content on how to accomplish specific tasks, reducing the learning curve and time normally spent on deploying TrueNAS in a variety of storage environments.

Here is the full list of fixes and changes in 12.0-RC1:

Bug Fixes

NAS-107506Additional Domains don't show up on saveMiddleware, WebUI
NAS-107475Just updated NextCloud Plugin. WebUI now refuses connectionPlugins
NAS-107409nfs shares can be created outside zpool pathMiddleware
NAS-107407Default uid for new users may be less than 1000Middleware
NAS-107402Migration of SMB "show hidden files" option is backwards
NAS-107371M60 traceback with enclosure.query callMiddleware
NAS-107361TrueNAS Scale: Empty create smb share
NAS-107346Problems with listing and deleting jails and pluginsMiddleware
NAS-107340Fix NULL dereference in smbd_smb2_getinfo_send()SMB
NAS-107332Issue with 2FA in TrueNAS Core 12 Beta2System
NAS-107328ACL editor does not reflect preselected templateWebUI
NAS-107316UPS Settings Saving BugWebUI
NAS-107315middlewared memory leakMiddleware
NAS-107314Replicated dataset is not set to read-onlyReplication
NAS-107302Inappropriate message / incorrect handling, when an old config references datasets/vols that no longer exist.WebUI
NAS-107292Unable to Delete Expired ACME CertificateCertificates
NAS-107270Critical Permissions issue in ZFS on FreeBSDZFS
NAS-107263When running a scrub from the pools manual it shows a GUI bugConsole
NAS-107261Creation date lost on move from Windows 10 client
NAS-107260Date columns do not sort correctlyWebUI
NAS-107257WebUI Pool Status emptyWebUI
NAS-107256Cluster of service fails and middleware connections fails, 12-beta2
NAS-107248Snapshot Extra column "Used", incorrect sorting
NAS-107241TrueNAS creating datasets out of nowhere and mounting over existing foldersZFS
NAS-107235Error when updating a Jail 11.3-RELEASE-p6 to 11.3-RELEASE-p612Middleware
NAS-107226middlewared_truenas/plugins/enclosure_/map.py TypeError line 66Middleware
NAS-107213SMB Service Save - TypeError occursSMB
NAS-107171TrueNAS not detecting PCIe devicesOS
NAS-107165Cannot add cache disk to existing pool
NAS-107164Jails not mounting after update to 12.0BETA2
NAS-107162UI refers to smb5.conf, but should read smb4.confWebUI
NAS-107159Incorrect Estimated Raw Capacity with Zpool Expansion via Repeat Vdev Method
NAS-107158Unable to upload config file in 12.0 BETA2
NAS-107156Expand testing for SMB homes shares
NAS-107154Fix issue with smb share generation
NAS-107153mutex if_addr_lock not owned at in_mcast.c:263OS
NAS-107143Ensure groupmap entries are properly added / deleted on group.update
NAS-107142Add tests for SMB groupmaps
NAS-107137zfs process dumps core in 12.0-BETA w/ jail zfs datasetsZFS
NAS-107135SMB status change does not update passdb/groupmap
NAS-107129SMART test results doesn't handle 0 results
NAS-107123Add catia mappings for special Apple characters
NAS-107121`failover_aliases` and `failover_virtual_aliases` are being overwritten as empty arraysWebUI
NAS-107120change failover_vhid to type `select` instead of `input`WebUI
NAS-107116allow editing empty interfaces
NAS-107112Strip newline from plugin-properties
NAS-107108Google Drive Cloud Sync tasks fail with exportSizeLimitExceededCloud Credentials
NAS-107104ACME DNS renewals don't workCertificates
NAS-107102Report HA in usage statisticsMiddleware
NAS-107101Top bar "resilvering" shows 0% constantly when it's 60% done.
NAS-107099Do not display previous replication task status after deleting it and…
NAS-107085Disable fruit:locking on time machine shares
NAS-107073Dashboard interface cards show impossible throughput values
NAS-107070Samba path suffix seems permanently disabled - can't change content even if share disabled and no connectionsWebUI
NAS-107060NFS statistics GUI are wrong.
NAS-107055Forums user reported logs filled with fruit error messagesSMB
NAS-107053Pool in dashboard omits special vdevs from count and statusWebUI
NAS-107052Cannot replicate encrypted datasets
NAS-107050Jails not auto-started after unlocking encrypted iocage dataset
NAS-107049zfs send errors out if sending > around 1000 snaps?ZFS
NAS-107046Cannot seem to delete network interfacesWebUI
NAS-107035Swap size setting not honored on 4k sector disksWebUI
NAS-107032Unable to upload 8TB file to backblaze.Middleware
NAS-107031OpenVPN autostart not working
NAS-107029Unable to configure UPS on TrueNAS 12WebUI
NAS-107023Expand list of error strings that should trigger an AD rejoin
NAS-107009System generated SSH host key does not persist through rebootOS
NAS-107007OpenVPN Service : Additional parameter need to be textareaServices
NAS-106999Human-readable error for deleting used cloud credential
NAS-10699524h clock not shown on dashboardWebUI
NAS-106994OpenVPN Service : Could not determine IPv4/IPv6 protocol
NAS-106991Reduce SMB-related log entries
NAS-106988Attempting to export/offline share while in use causes crash/exception
NAS-106984"jls" hostname does not reflect modified hostname
NAS-106981Changing Default ACL Options resetting user changes
NAS-106965qBittorrent Plugin Not InstallingPlugins
NAS-106964Overlapping tooltipsWebUI
NAS-106959Enabling LZ4 encryption on a ZFS pool results in a "middlewared.schema.Error: [aclmode] Invalid choice: DISCARD" errorDocumentation
NAS-106955Clarify reboot instructions in installerInstallation
NAS-106941Incorrect parent check when unlocking encrypted datesetMiddleware
NAS-106879return SCALE_ENTERPRISE when on SCALE and licensedMiddleware
NAS-106878exclude nvme boot disks from fenced on freeBSDMiddleware
NAS-106875Add directory services to usage statsMiddleware
NAS-106866Proper/better errno for failed authenticationMiddleware
NAS-106864SED doesn't work for nvmeMiddleware
NAS-106842Setting IPMI to DHCP should gray-out IP addressesWebUI
NAS-106840setting invalid VHID value fails silently.HA, WebUI
NAS-106826fix hardware detection for M and X on SCALEMiddleware
NAS-106818When replicating without a Periodic Snapshot task, Recursive is not working.Replication
NAS-106798api context /services/iscsi/targettoextent does not allow null value for iscsi_lunidAPI, iSCSI
NAS-106504Samba:s3:winbindd - append newline to end of status message
NAS-106452Invalid zfs send via libzfs leads to kernel panicZFS
NAS-106164update.check_available tracebacks on TN HAMiddleware
NAS-104906Rsync tasks view shows incorrect remote pathTasks
NAS-102808Running Cloud Sync tasks keep on running after deletion in GUICloud Credentials, Middleware

Known Issues

NAS-106959Activating LZ4 compression on a previously unencrypted storage pool that was created in a nightly build then upgraded to BETA1 can fail.When selecting the compression algorithm, also open the Advanced Options and set ACL Mode to Passthrough.
NAS-107151Replication fails between legacy TrueNAS 9.10 systems and 12.0-BETA1 systems.Due to numerous improvements in the replication engine and ZFS, FreeNAS/TrueNAS 9.10 systems (or earlier) can no longer replicate to or from TrueNAS 12.0. Update the legacy TrueNAS system to FreeNAS/TrueNAS 11.3 or newer.
NAS-106992Persistent L2ARC is disabled by default due to performance impact when rebuilding with large amounts of data.Reactivating persistent L2ARC can result in degraded UI and Middleware performance in specific situations where large amounts of data is loaded into L2ARC and a rebuild is triggered. To 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
NAS-107532TrueNAS “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.
N/ACustom SMB VFS Auxiliary Parameters can cause issues when upgrading to new versions of TrueNASWhen upgrading to TrueNAS 12.0, it is recommended to review and remove any additional SMB auxiliary parameters that relate to VFS modules. TrueNAS 12.0 has improved SMB support that has made many of these modules obsolete and they can interfere with the upgrade process.