TrueNAS SCALE Version Documentation
This content follows the TrueNAS SCALE 24.04 (Dragonfish) releases. Use the Product and Version selectors above to view content specific to different TrueNAS software or major version.
24.04 (Dragonfish) Version Notes
20 minute read.
24.04 Dragonfish
There are many new features and continued improvements to the TrueNAS SCALE experience:
New SMB and NFS status pages for active session monitoring and administration.
New Auditing feature! Administrators can keep and view audit logs about SMB clients and other TrueNAS UI authorization and account activity.
New support for FreeIPA configurations is added to the LDAP credentials fields!
New Community feature: SCALE Sandboxes provide a similar functionality to TrueNAS CORE jails or Linux LXC containers.
New Community feature: unsupported Developer mode for customizing TrueNAS.
New Dashboard widget for monitoring and quick creation of data backup tasks.
Exposed Netdata UI under Reporting > Netdata for deeper real-time introspection and reporting on system performance.
Reworked Share creation forms for a faster and smoother experience.
Reworked Cloud backup form to improve the user experience.
Expanded feedback system for rating UI screens and creating TrueNAS project bug reports or improvement suggestions.
ZFS ARC memory allocations are updated and behave identically to TrueNAS CORE.
New privilege levels for TrueNAS administrative users for greater system security hardening.
Linux kernel and NVIDIA driver updates.
Improved performance for SMB Shares with directories containing large file counts.
Third-Party SMB Data Migration from external sources.
24.04 (Dragonfish) is available from the TrueNAS SCALE download page.
For adventurous users that want to experiment with the latest developments, nightly build .iso and .update files are also available.
More details are available from Software Releases.
The release names and dates provided here are tentative and can change at any time.
SCALE™ | Enterprise™
Previous
Current
Next
TrueNAS SCALE 24.10 - Electric Eel
Latest:Anticipated:
After updating, clear the browser cache (CTRL+F5) before logging in to SCALE. This ensures stale data doesn’t interfere with loading the SCALE UI.
TrueNAS SCALE is an appliance built from specific Linux packages. Attempting to update SCALE with
aptor methods other than the SCALE web interface can result in a nonfunctional system.Users with unofficial apps installed should review app storage drivers to determine if any utilize the OpenEBS-ZFS container storage interface (CSI) before upgrading. This CSI is not supported in TrueNAS SCALE 24.04 (Removal Notice). Unofficial apps that use OpenEBS-ZFS CSI drivers should maintain functionality for existing deployments, but users are not able to make backups or restore any existing backups for those apps. New users are not able to install and deploy these apps.
All auxiliary parameters can experience changes between TrueNAS major versions due to security and development changes. We recommend removing all auxiliary parameters from TrueNAS configurations before upgrading as these settings can result in SMB share failures after an upgrade.
TrueNAS SCALE 24.04 (Dragonfish) no longer includes the deprecated gluster component. Systems installed with 24.04 cannot be used in experimental TrueCommand clusters. Community users that experimented with this now-deprecated TrueCommand feature need to migrate any data from the TrueCommand cluster and delete it before upgrading any clustered SCALE systems to 24.04.
Several built-in services from SCALE 22.12 (Bluefin) in System Settings > Services are replaced by community applications (details). SCALE 22.12 (Bluefin) systems must disable these built-in services and begin using the equivalent application before upgrading to SCALE 23.10 (Cobia), before upgrading to SCALE 24.04, or users can force an upgrade without disabling them. This is not recommended for the S3 service as you must migrate the MinIO service and data or lose it.
SCALE 24.04 changes the default user home directory location from /nonexistent to /var/empty. This new directory is an immutable directory shared by service accounts and accounts that should not have a full home directory.
The 24.04.01 maintenance release introduces automated migration to force home directories of existing SMB users from /nonexistent to /var/empty.
See Managing Users for more information.
Users upgrading from TrueNAS SCALE 23.10 (Cobia) to 24.04 (Dragonfish) who import a Cobia configuration file might find that some services are not automatically enabled as expected. After uploading the configuration file and rebooting the system, review System Settings > Services. For any services that should be enabled, set it to Running and Start Automatically.
There are a variety of options for upgrading to SCALE 24.04.
With a stable release, upgrading to SCALE 24.04 (Dragonfish) from an earlier SCALE release is primarily done through the web interface update process. Another upgrade option is to use a SCALE .iso file to perform a fresh install on the system and then restore a system configuration file.
See the TrueNAS Software Status page for recommendations about which software version to use based on your user type.
Update the system to the latest maintenance release of the installed major version before attempting to upgrade to a new TrueNAS SCALE major version.
flowchart LR
A["22.02.4 (Angelfish)"] -->|update| C
B["CORE 13.0-U6.2
CORE 13.3-RELEASE"] -->|ISO install| E
C["22.12.4.2 (Bluefin)"] -->|update| D
D["23.10.2 (Cobia)"] -->|update| E
E["24.04.2.5 (Dragonfish)"] -->|update| H
H["24.10.0.2 (Electric Eel)"]
flowchart LR
A["CORE 13.0-U6.2"] -->|ISO install| D
B["Current 23.10 (Cobia) release"] -->|update| C
C["23.10.2 (Cobia)"] -->|update| D
D["24.04.2.5 (Dragonfish)"] -->|"(anticipated)"| E
E["24.10.0.2 (Electric Eel)"]
Enterprise customers should contact iX Support for assistance with migrating.
Migrating TrueNAS from CORE to SCALE is a one-way operation. Attempting to activate or roll back to a CORE boot environment can break the system.
Upgrade your CORE system to the latest publicly-available 13.0-U6.2 (or later) release before attempting to migrate from CORE to SCALE.
You can use the UI update screens to migrate from CORE 13.0-U6.2 or CORE 13.3 to SCALE 24.04 (or earlier). Later releases of SCALE do not support migrations from CORE releases. These migrations cannot be done, and either fail or result in error conditions that cannot be resolved.
Alternately, fresh installing TrueNAS from an
.iso file and restoring a previously downloaded 13.0 or 13.3 configuration file can migrate a system to 24.04. This requires careful review of the system settings and recreation of TrueNAS administrator accounts after the configuration file restore process completes.Download the
iso or.update for the latest maintenance release of TrueNAS 24.04 (see Software Releases) and follow the instructions in this section.
TrueNAS Enterprise
When attempting to migrate from TrueNAS CORE, the general recommendation is to back up the system configuration file and use a SCALE .iso file to fresh install TrueNAS. After install, restore the system configuration and import the pools.
Depending on the specific system configuration, this can be a straightforward or complicated process. See the Migration articles for cautions and notes about differences between each software and the CORE to SCALE migration process.
You must either clean install or use an upgrade *iso file to migrate a TrueNAS CORE system to SCALE 24.04 (Dragonfish). Enterprise customers should contact Support for assistance with transitioning from CORE to SCALE.
Click the component version number to see the latest release notes for that component.
| Component | Version |
|---|---|
| Debian Base | 12 (Bookworm) |
| Linux Kernel | 6.6.32 |
| NVIDIA Driver | 545.23.08-2 |
| OpenZFS | 2.2.4-2 |
24.04.2.1 (Dragonfish) has the same OpenZFS major version as 23.10.1 (Cobia).
The items listed here represent new feature flags implemented since the previous update to the built-in OpenZFS version (2.1.11).
| Feature Flag | GUID | Notes |
|---|---|---|
| blake3 | org.openzfs:blake3 | |
| block_cloning | com.fudosecurity:block_cloning | |
| draid | org.openzfs:draid | |
| head_errlog | com.delphix:head_errlog | |
| vdev_zaps_v2 | com.klarasystems:vdev_zaps_v2 | |
| zilsaxattr | org.openzfs:zilsaxattr |
For more details on feature flags, see OpenZFS Feature Flags and OpenZFS zpool-feature.7.
November 8, 2024
iXsystems is pleased to release TrueNAS 24.04.2.5! This is a release to address another high-impact issue discovered with SMB memory management.
- Fix Management of SMB AIO read buffers (NAS-132365).
Users with 24.04.2.4 installed and SMB shares in use are encouraged to upgrade to this release immediately.
- An issue has been discovered for cloud sync tasks configured with file name encryption, which is available in Advanced Remote Options (NAS-132472). As this is an upstream issue in rclone, we recommend that users should not create new cloud sync tasks with the Filename Encryption setting enabled. Existing users of this feature must leave it enabled for existing cloud sync tasks to be able to recover backups.
Please see the 24.04.2 changelog below and use the Jira filter links to see the full changelog and known issues related to the 24.04.2 > 24.04.2.5 releases.
November 7, 2024
iXsystems is pleased to release TrueNAS 24.04.2.4! This is a release to address a small number of issues discovered in the 24.04.2.3 release.
- Fix memory consumption related to SMB AIO reads (NAS-132166).
- Fix HA logic bug to ensure marked critical interfaces are treated as critical (NAS-132115).
- Prevent SED pool degradation after power loss (NAS-129366).
- Users have reported an issue with SMB memory management under heavy SMB loads. A fix for this issue is in the 24.04.2.5 release version.
Please see the 24.04.2 Jira changelog below and use the Jira filter links to see the full changelog and known issues related to the 24.04.2 > 24.04.2.4 releases.
October 10, 2024
iXsystems is pleased to release TrueNAS SCALE 24.04.2.3! This is a hotpatch to address two issues in the previous 24.04.2.2 release, primarily affecting some TrueNAS Enterprise customers with High Availability (HA) systems and failover enabled.
- An issue was discovered where the TrueNAS UI can send an improper payload for the Outboard Activity option when re-saving an edit to global network settings (NAS-131787). Users who encounter this issue can upgrade to 24.10.0 where the issue is corrected.
Please use the 24.04.2 Jira filter links below to see the full changelog and known issues related to the 24.04.2, 24.04.2.1, 24.04.2.2, and 24.04.2.3 releases.
September 17, 2024
iXsystems is pleased to release TrueNAS SCALE 24.04.2.2! This is a hotpatch to address an issue in the previous 24.04.2.1 release where failover-related Proactive Support alerts were being triggered too often on some TrueNAS Enterprise platforms.
Please use the 24.04.2 Jira filter links below to see the full changelog and known issues related to the 24.04.2, 24.04.2.1, and 24.04.2.2 releases.
September 11, 2024
iXsystems is pleased to release TrueNAS SCALE 24.04.2.1! This is a small maintenance release and includes refinement and fixes for issues discovered after the 24.04.2 release.
- Adds proactive support and auto-alerts for unscheduled failovers, reboots, and unexpected High Availability (HA) issues. When licensed for HA and the Proactive Support feature is configured, failover events generate a Support ticket with the corresponding support license notated NAS-130591.
- Fix bug with case preservation when MacOS clients access an SMB share NAS-130743.
Please use the 24.04.2 Jira filter links below to see the full changelog and known issues related to the 24.04.2 and 24.04.2.1 releases.
July 9, 2024
iXsystems is pleased to release TrueNAS SCALE 24.04.2! This is a maintenance release and includes refinement and fixes for issues discovered after the 24.04.1 and 24.04.1.1 releases.
Fixes implemented for CVE-2024-6387, noted as the “regreSSHion” vulnerability. Additional details and links to the technical discussion and analysis of the vulnerability are available from NAS-129828.
TrueNAS SCALE Enterprise users should update to 24.04.2 as soon as possible to address this vulnerability.
Linux kernel updated to 6.6.32 (NAS-129293).
TrueNAS zfs synced with upstream OpenZFS 2.2.5-staging (NAS-129592).
Additional fixes to prevent OOM errors due to ZFS ARC caching with heavy NFS workloads (NAS-129533).
Simplify file artifact generation that prevented debug generation with large numbers of files per directory (NAS-128779).
Fixed ACL form bug when directory services cache is disabled (NAS-129528).
Prevent app service disruption when the interface has a configured description (NAS-129150).
Show only pods which are running when retrieving choices for pod console access (NAS-128919).
Bug fix for cloud sync tasks with filename encryption (NAS-127485).
Fix range validator for apps config arguments (NAS-128590).
Fixed bug that caused cloud sync tasks to include the ix-applications dataset when it should have been excluded (NAS-129488).
Fixed bug that prevented editing the share Purpose for existing SMB shares (NAS-128987).
Allow configuration of a wider range of MTU values (NAS-129608).
Prevent Netdata and k3s log spam that caused excessive writes to the boot pool (NAS-129384 and NAS-129383).
Fixed ipmitool bug with updated IANA Enterprise numbers (NAS-128598).
Prevent 90 second shutdown timeout for VMs that are not started (NAS-129481).
Click here for the full changelog of completed tickets that are included in the 24.04.2 release.
Systems migrating from 13.0-U6.2 that have storage pools with cache and spare devices can show, post-upgrade to 24.04.2, pools as having unavailable devices and other disk detection errors (NAS-130825). This is caused by a difference between how CORE and SCALE identify devices for pool import. To work around this issue, use the TrueNAS UI to export the affected pool and then re-import it.
Network UPS Tools (NUT) service can utilize 100% of 1 CPU thread when power is cut to the UPS NAS-130175. This issue is resolved in a new version of the related service, which will be made available in a future TrueNAS release when the updated NUT version is moved into upstream stable Debian repositories.
Click here to see the latest information about public issues discovered in 24.04.2 that are being resolved in a future TrueNAS SCALE release.