12.0-RC1

7 minute read.

Last Modified 2024-12-11 11:47 EST

TrueNAS Quality Lifecycle

Release Stage	Completed QA Cycles	Typical Use	Description
NIGHTLY	0	Developers	Incomplete
ALPHA	1	Testers	Not much field testing
BETA	2	Enthusiasts	Major Feature Complete, but expect some bugs
RC	4	Home Users	Suitable for non-critical deployments
RELEASE	6	General Use	Suitable for less complex deployments
U1	7	Business Use	Suitable for more complex deployments
U2+	8	Larger Systems	Suitable 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

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

Known Issues

Key	Summary	Workaround
NAS-106959	Activating 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-107151	Replication 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-106992	Persistent 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-107532	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.
N/A	Custom SMB VFS Auxiliary Parameters can cause issues when upgrading to new versions of TrueNAS	When 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.