TrueNAS Early Release Documentation
This content follows TrueNAS 24.10 (Electric Eel) development versions. Early release software is intended for testing purposes only.
Use the Product and Version selectors above to view content specific to a stable software release.

24.10 (Electric Eel) Version Notes

10 minute read.

Last Modified 2024-09-03 14:51 EDT

24.10 Electric Eel

This page tracks the latest development roadmap and release notes for the next upcoming TrueNAS SCALE major version, 24.10 (Electric Eel). The stable 24.04 (Dragonfish) release notes are available with documentation for that version.

Features

24.10 (Electric Eel) brings many new features and improvements to the TrueNAS SCALE experience:

The TrueNAS Apps feature backend moves from Kubernetes to Docker to streamline App deployment and management (announcement). Custom App deployment is being reworked with Docker Compose integration.
Extend a RAIDZ vdev with individual disks (OpenZFS feature sponsored by iXsystems).
New TrueCloud Backup Tasks with streamlined functionality for Storj iX cloud backups and restoration.
New global search for finding pages and settings in the SCALE UI.
Dashboard reworked with more widgets, data reporting, and customization.
UI support for NVMe S.M.A.R.T. tests.
Align Enclosure Management code with CORE and improve the feature’s performance.

Preserve SMB alternate data streams when ingesting data from remote servers.
Rewrite TrueNAS installer to better support future development efforts.
Polish UI table presentation and integrate with global search (NAS-127222).
Replace nslcd with sssd to improve Kerberos, NFS, and SMB support in non-AD environments (NAS-127073).
Generate a unique system ID for each SCALE install (NAS-123519).
ZFS Fast Deduplication (OpenZFS feature sponsored by iXsystems): This feature is partially present in TrueNAS, but is considered experimental and disabled by default in 24.10. Full UI integration is anticipated in a future TrueNAS release (NAS-127088).

Obtaining a Release

Early releases of a major version are intended for testing and feedback purposes only. Do not use early release software for critical tasks.

24.10 (Electric Eel) early releases (BETA and RC) are available from the TrueNAS SCALE download page.

For adventurous users that want to experiment with the latest feature development, nightly build .iso and .update files are available.

More details are available from Software Releases.

Release Schedule

The release names and dates provided here are tentative and can change at any time.

SCALE™ | Enterprise™

Current

Software Lifecycle

TrueNAS Quality Lifecycle

TrueNAS releases follow a general adoption guideline for their lifetime. Starting with the NIGHTLY builds, each stage of a major release incorporates more testing cycles and bug fixes that represent a maturation of the release. With each version release stage, users are encouraged to install, upgrade, or otherwise begin using the major version, depending on the specific TrueNAS deployment and use case:

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

The Software Status page shows the latest recommendations for using the various TrueNAS software releases.

Upgrade Notes

TrueNAS SCALE is an appliance built from specific Linux packages. Attempting to update SCALE with apt or methods other than the SCALE web interface can result in a nonfunctional system.
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.
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.
24.10 moves the applications backend from Kubernetes to Docker (announcement).
- Supported catalog applications automatically migrate to Docker deployments on upgrade from from 24.04 (Dragonfish) to Electric Eel.
  App migration is receiving active development in 24.10-BETA.1. To see which applications currently support automatic migration, see the Parity Status with truenas/charts chart from the /truenas/apps/ github repository. Applications that support migration display a green check (✅) in both Added and Migrated columns. Check back regularly and note the update history of the README.md file for the latest developments.
  Configuration data for applications that do not automatically migrate is retained in the ixapplications dataset. You can re-initiate migration of previously-installed Kubernetes apps to Docker at any time after upgrading to Electric Eel, for example to migrate an app that was not yet available for automatic migration upon upgrade but is now available. From a shell session enter midclt call -job k8s_to_docker.migrate poolname , where poolname is the name of the applications pool.
- Custom apps are not supported for migration on 24.10-BETA.1. The Custom App installation screen is disabled. A redesigned screen, including Docker Compose support, is anticipated for the RC.1 version. Users wishing to leverage Docker Compose in BETA can do so using the Dockge or Portainer apps, available from the Community train, or in a Sandbox.
Starting in 24.10, TrueNAS does not install a default Nvidia driver. This allows for driver updates in between TrueNAS release versions.
A UI selectable option to install/update Nvidia drivers is planned for a future 24.10 development version. Users needing Nvidia GPU support in 24.10.BETA.1 can enable this option from a shell session using the command midclt call -job docker.update '{"nvidia": true}' .
Support for the deprecated LDAP Samba Schema is removed in 24.10. Users with both LDAP and SMB shares configured should migrate legacy Samba domains to Active Directory before upgrading to 24.10.
Electric Eel introduces redesigns of the UI Dashboard and View Enclosure screens with numerous improvements to system and enclosure management. 24.10-BETA-1 includes both the new and legacy screen versions. Legacy versions are identified as (old) in the navigation menu.
Removal of the legacy Dashboard and View Enclosure screens is anticipated in the RC.1 release version.
SMB audit log entries are omitted by default from the System > Audit screen. To view SMB audit results, go to System > Services and click Audit Logs for the SMB service or use advanced search on the main Audit screen to query SMB events.

Upgrade Paths (Anticipated)

With a stable release, upgrading to SCALE 24.10 (Electric Eel) from an earlier SCALE release is primarily done using 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 (Dragonfish)"] -->|anticipated| H
            H["24.10.0 (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 (Dragonfish)"]  -->|anticipated| E
            E["24.10.0 (Electric Eel)"]

CORE to SCALE Migrations

TrueNAS Enterprise
Enterprise customers with HA systems should contact iXsystems Support for assistance with migrating to TrueNAS SCALE.
iXsystems Support

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 using an iso or use an upgrade file to migrate a TrueNAS CORE system to SCALE 24.10 (Electric Eel). Enterprise customers should contact Support for assistance with transitioning from CORE to SCALE.

Component Versions

Click the component version number to see the latest release notes for that component.

Component	Version
Linux Kernel	6.6.44
OpenZFS	2.2.99-2

OpenZFS Feature Flags

TrueNAS integrates many features provided by the upstream OpenZFS project. Any new feature flags introduced since the previous OpenZFS version that was integrated into TrueNAS (OpenZFS 2.1.11) are listed below:

Feature Flag	GUID	Notes
raidz expansion	org.openzfs:raidz_expansion
redaction list spill	com.delphix:redaction_list_spill

For more details on feature flags, see OpenZFS Feature Flags and OpenZFS zpool-feature.7.

24.10-BETA.1 Changelog

Early releases are intended for testing and feedback purposes. Do not use early-release software for critical tasks.

August 29, 2024

iXsystems is pleased to release TrueNAS 24.10-BETA.1! This has software component updates and new features that are in the polishing phase.

Notable changes:

Dashboard reworked with more widgets, data reporting, and customization (NAS-127217).
Applications backend framework is shifted from Kubernetes to Docker. See the official announcement for more information. The Custom App installation screen is disabled in 24.10-BETA.1. A redesigned screen, including Docker Compose support, is anticipated for the RC.1 version. See Upgrade Notes for more information.
New TrueCloud Backup Tasks with streamlined functionality for Storj iX cloud backups and restoration (NAS-127165).
Extend a RAIDZ vdev with individual disks (OpenZFS feature sponsored by iXsystems) (NAS-123548).
New global search for finding pages and settings in the SCALE UI (NAS-127224).
UI support for NVMe SMART tests NAS-128116
Align Enclosure Management code with CORE and improve the feature’s performance (NAS-123474).
Improved web UI tables (NAS-113063).
Preserve SMB alternate data streams when ingesting data from remote servers (NAS-127114).
Rewrite TrueNAS installer to better support future development efforts (NAS-127092).
The Allow root login option is removed from the FTP service (NAS-128837).
Implement a globally unique system ID (NAS-123519).
Remove creation/reporting/management of swap on TrueNAS (NAS-12887).
Rename the default administrator account (UID 950) from admin to truenas_admin to prevent DS conflicts (NAS-129997). This change affects fresh installs of 24.10 only. Existing admin accounts are preserved on upgrade.
For improved security, we recommended that users create a unique administrator account and disable password access for default administrator accounts. See Using Administrator Logins for more information.
SMB audit log entries are omitted by default from the System > Audit screen (NAS-130498). To view SMB audit results, go to System > Services and click Audit Logs for the SMB service or use advanced search on the main Audit screen to query SMB events.
Fix IPv6 bind for VM display (NAS-128102).
Replace nslcd with sssd (NAS-127073).
Fix management of SNMPv3 user (NAS-128335).

Click here for the full changelog of completed tickets that are included in the 24.10-BETA.1 release.

To switch between detail and list views for the changelog, press t. Open the changelog in Jira to see the Export menu to print or download the changelog in various file formats.

24.10-BETA.1 Known Issues

The System > Audit screen can display different values for Timestamp in the entries list and Localtime in Event Data, depending on the local timezone of the system (NAS-130373).
Some users have reported incomplete shutdown and reboot behavior (NAS-130118). This issue has not been reported in iXsystems hardware.
Unexpected behavior can occur when unlocking a dataset with recursive set to false (NAS-130329). Child datasets with inherited keys are also unlocked with the parent dataset.
Development of the new TrueCloud backup feature for TrueNAS and Storj integration is ongoing, with fixes for known issues expected in a future 24.10 development version release (NAS-130320, NAS-130794, and NAS-130644).
Auto-populated portal group IDs for iSCSI configurations can differ between the Portals and Targets screen. This is a cosmetic issue in the UI and underlying functionality is not impacted (NAS-130656).
Audit logging status indicators on SMB share tables might not accurately reflect if logging is or is not enabled on a given share (NAS-130830).
App icons can periodically fail to render on the Discover applications screen, especially when searching for applications (NAS-130831).
On the virtual machine creation screen, a validation error displays if a configured GPU device is not valid for use in the VM. However, in some cases it can be possible to continue and create the VM with an invalid GPU configuration (NAS-130754). If you receive a GPU validation error during VM creation, remove or correct the invalid GPU before creating the VM.

Click here to see the latest information about public issues discovered in 24.10-BETA.1 that are being resolved in a future TrueNAS SCALE release.