The TrueNAS team is pleased to release TrueNAS 26-BETA.1!
Early Release Software
Early releases are intended for testing and feedback purposes. Do not use early-release software for critical tasks.
This first public release version of TrueNAS 26 has software component updates and new features that are in the polishing phase. See 26 Major Features for an overview of what’s new in this release.
Upgrading from TrueNAS 25.10
Upgrading from TrueNAS 25.10 to 26-BETA.1 is not available in the TrueNAS UI until TrueNAS 25.10.3 is released. Users on TrueNAS 25.10 who wish to test 26-BETA.1 before that time can manually install or upgrade by downloading directly:
Special thanks to (GitHub users): Franco Castillo, AquariusStar, Rogelio Tajes Piñeiro, Aurélien Sallé, dany22m, ReiKirishima, Christos Longros, Lee Jihaeng, Aui162, Seele Volleri, Ban, Michael Rohrhirsch, PCAsusM1981, Cantabile, Fernando G. Monteiro, Joda Stößer, Marius, herbkk, saso-g1, René, Jehu Marcos Herrera Puentes, Amir Burbea, Piotr Jasiek, Eric Schultz, Kent Ross, fkwp, Gautam krishna R and Joel May for contributing to TrueNAS 26-BETA.1. Visit our guide for information on how you too can contribute.
26-BETA.1 Notable Changes
- Adds support for LXC containers in Enterprise High Availability (HA) configurations (NAS-138309). Containers can now fail over between HA controllers. HA container failover requires a static IP configuration. See Containers for configuration details.
- Adds GPU passthrough support for LXC containers (NAS-138569, NAS-138570, NAS-138700). Users can assign NVIDIA and other supported GPU devices to LXC containers from the container configuration screen in the UI.
- Adds Multi-Path I/O (MPIO) support for Fibre Channel connections (NAS-137252). Fibre Channel configurations can now use multiple paths for improved redundancy and throughput. This option is available in the Fibre Channel port configuration.
- Adds SMB3 unix extensions support for multiprotocol shares (NAS-139988). When a share uses the Multi-Protocol purpose (for example, SMB combined with NFS or local app and container access), TrueNAS now enables SMB3 unix extensions. Linux clients with SMB3 POSIX support can use filesystem primitives not normally available through standard SMB semantics. Windows clients without unix extension support continue to behave normally.
- Adds BRT (Block Reference Table) support to the
zpool prefetchcommand for faster pool import operations (NAS-139230). Pool imports on systems that use block cloning are now faster, as the prefetch operation includes BRT metadata. - Adds an option to de-register a system from TrueNAS Connect (NAS-139544). Users can now remove a system’s TrueNAS Connect registration from the TrueNAS Connect configuration screen without needing to contact support.
- Adds support for the
include:key in custom app Docker Compose configurations (NAS-137498). Custom app Compose files can now reference external Compose files that define services, allowing users who manage their own Docker Compose files outside TrueNAS to use modular configurations. - Updates the Pools and storage screens to reflect OpenZFS 2.4 changes, including the new separation of special and dedup vdev types (NAS-138129). Pool creation and management dialogs now correctly represent the new vdev types available in OpenZFS 2.4.
- Improves the Storage Dashboard to show the reason a pool is degraded (NAS-138613). Previously, a degraded pool indicator offered no detail on the cause. The dashboard now provides context so users can take corrective action.
- Updates the Samba build to version 4.23 (NAS-139190). See the Samba 4.23.0 release notes for upstream changes. Note that changes to Samba defaults do not necessarily change TrueNAS defaults. See Software Component Versions for all component version updates in this release.
- Improves touch and mobile usability for side panels and configuration screens (NAS-139925, NAS-139786, NAS-138896). Side panels now scroll correctly in mobile browsers, canvas edge spacing is improved for touch targets, and the Save button on the Add Rsync Task screen is no longer hidden on small screens.
- Fixes TrueNAS updates failing with errors that could leave apps non-functional or set a broken boot environment as default (NAS-139794, NAS-139545). A “pool or dataset is busy” error during updates could set an incomplete boot environment as default. A separate regression also caused apps to fail to start after updating. Both issues are resolved.
- Fixes the System > Services screen showing as empty (NAS-139571). A regression could cause the services list to appear blank on affected systems, preventing users from starting, stopping, or configuring services from the UI.
- Fixes an issue where datasets could not be loaded in the UI (NAS-140389). A middleware issue could prevent dataset information from loading on the Datasets screen, showing an error instead of the dataset tree.
- Fixes available space calculations for pools with special or dedup vdevs (NAS-139820). Incorrect accounting could cause available space to display inaccurate values on pools using special allocation or dedup vdevs.
- Fixes an issue where virtual DRAID devices appeared as physical disks in the disk inventory (NAS-140344). On pools using DRAID vdevs, virtual devices could be incorrectly counted alongside physical drives, causing inaccurate disk inventory results.
- Fixes datasets becoming unavailable after a ZFS send replication operation (NAS-139363). A ZFS issue could cause target datasets to enter an unavailable state after a send operation completed. Datasets are now accessible immediately after replication finishes.
- Fixes a boot delay of up to 120 seconds on systems with VLAN interfaces configured for DHCP (NAS-139038). Systems using VLAN interfaces with DHCP experienced long waits during boot due to a
dhcpcdconfiguration issue. Boot now completes without the delay. - Fixes an error that prevented setting secondary IP address aliases on network interfaces (NAS-139803). A
KeyError: 'alias_interface_id'error could occur when saving secondary aliases in the network interface configuration. - Fixes the Samba Spotlight metadata service connection so that macOS Spotlight search works correctly on SMB shares (NAS-137715). The Spotlight AF_UNIX socket connection was established as a non-privileged user, causing authentication failures. The connection now runs with the correct permissions.
- Fixes an error that prevented editing share ACLs (NAS-139535). Users attempting to modify permissions on SMB or NFS shares through the ACL editor could receive errors and be unable to save changes.
- Fixes NFS shares showing no available actions in the Shares screen (NAS-139490). The action buttons for NFS shares could fail to render correctly, preventing users from editing or deleting NFS shares from the UI.
- Fixes an error that prevented updating an iSCSI auth method when Mutual CHAP was selected (NAS-139397). Users could not save changes to iSCSI authorized access entries with Mutual CHAP configured.
- Fixes USB and PCIe device passthrough to virtual machines (NAS-139045, NAS-139356). A regression in an earlier nightly build broke the ability to pass USB and PCIe devices through to VMs. Both USB and PCIe passthrough are restored in BETA.1.
- Fixes Rsync task setup failures related to remote path validation and host key verification (NAS-139773). Remote path validation could incorrectly reject valid paths, and host key verification could fail even after accepting the key. Both issues are resolved.
- Fixes SNMP alerts that stopped sending notifications (NAS-140259). A regression could cause SNMP alert notifications to fail silently on affected systems. SNMP monitoring integrations relying on TrueNAS alerts now receive notifications correctly.
- Fixes the CPU reporting chart to show both per-core and total CPU usage (NAS-135633). The Reporting screen previously only showed aggregated CPU usage. Users can now view individual core utilization alongside the total.
- Fixes UI regressions introduced by an Angular framework upgrade, including session logouts on page refresh in Firefox and broken tooltips across multiple screens (NAS-139491, NAS-139342). Firefox users were logged out unexpectedly on page refresh, and tooltips and contextual popovers stopped working throughout the interface. Both issues are resolved.
- Fixes the TrueNAS web UI, preventing NVIDIA driver removal when the GPU has already been uninstalled (NAS-137282). When an NVIDIA GPU was physically removed, the UI did not allow removing the associated driver package. The driver can now be removed independently of hardware presence.
See the Release Notes and changelog for more details.
Documentation : TrueNAS Documentation Hub
Download : https://www.truenas.com/download-truenas-community-edition
Thank you for using TrueNAS! As always, we appreciate your feedback!