25.10 (Goldeye) Version Notes

October 28, 2025

The TrueNAS team is pleased to release TrueNAS 25.10.0!

Special thanks to (Github users): Aurélien Sallé, ReiKirishima, AquariusStar, RedstoneSpeaker, Lee Jihaeng, Marcos Ribeiro, Christos Longros, dany22m, Aindriú Mac Giolla Eoin, William Li, Franco Castillo, MAURICIO S BASTOS, TeCHiScy, Chen Zhaochang, Helak, dedebenui, Henry Essinghigh, Sophist, Piotr Jasiek, David Sison, Emmanuel Ferdman and zrk02 for contributing to TrueNAS 25.10. For information on how you can contribute, visit https://www.truenas.com/docs/contributing/.

New Features:

• NVMe over Fabric: TCP support (Community Edition) and RDMA (Enterprise) for high-performance storage networking with 400GbE support.
• Virtual Machines: Secure Boot support, disk import/export (QCOW2, RAW, VDI, VHDX, VMDK), and Enterprise HA failover support.
• Update Profiles: Risk-tolerance based update notification system.
• Apps: Automatic pool migration and external container registry mirror support.
• Enhanced Users Interface: Streamlined user management and improved account information display.

Performance and Stability:

• ZFS: Critical fixes for encrypted snapshot replication, Direct I/O support, improved memory pressure handling, and enhanced I/O scaling.
• VM Memory: Resolved ZFS ARC memory management conflicts preventing out-of-memory crashes.
• Network: 400GbE interface support and improved DHCP-to-static configuration transitions.

UI/UX Improvements:

• Redesigned Updates, Users, Datasets, and Storage Dashboard screens.
• Improved password manager compatibility.

Breaking Changes Requiring Action:

• NVIDIA GPU Drivers:
  • TrueNAS 25.10 switches to open GPU kernel drivers supporting Turing and newer (RTX/GTX 16-series+). Pascal, Maxwell, and Volta architectures are no longer supported. See NVIDIA GPU Support for compatibility details.
• Active Directory IDMAP:
  • The Active Directory AUTORID IDMAP backend is removed and auto-migrated to RID to improve consistency across multi-server environments. Users should review their ACLs and permissions after upgrade and might need to reconfigure them in some edge cases.
• Certificate Management:
  • 25.10 removes the Certificate Authority (CA) functionality that allowed TrueNAS to create and sign certificates. Users can continue to manage certificates by creating Certificate Signing Requests (CSRs) to be signed by external certificate authorities or and importing certificates that have been signed by external CAs or directory services. These alternatives provide the certificate management capabilities most users need while ensuring proper certificate validation through established certificate authorities.
• SMART Monitoring:

  • 25.10 removes the built-in SMART test scheduling and monitoring interface to improve user flexibility for disk monitoring. The smartmontools binaries remain installed and continue to be used internally by TrueNAS, ensuring that existing third-party scripts and monitoring tools continue to work unchanged. Users seeking advanced SMART monitoring can install the “Scrutiny” app from the TrueNAS catalog, which offers superior disk health tracking with historical data storage, customizable alerts, and automatic drive detection. TrueNAS maintains monitoring of critical disk health indicators and automatically migrates existing scheduled SMART tests to cron tasks during upgrade.

    See Disk Management for more information on disk health monitoring in 25.10 and beyond.

• SMB Shares:

  • In 25.10, SMB share configuration only displays options relevant to each purpose-based preset. Existing shares that previously used the No Preset option are automatically migrated to the Legacy Share preset during upgrade. New shares cannot access legacy configuration options.

    Legacy Share options include enabling SMB guest access, the SMB recycle bin, home directory export, AFP compatibility shares, and disabling shadow copies. The SMB recycle bin feature is no longer available for new shares due to security and usability concerns. For file recovery and versioning, use ZFS snapshots, which provide more reliable and predictable data protection. For more information, see Legacy Share Settings and the TrueNAS API documentation sharing.smb.create return values for options LegacyOpt.

• Virtual Machine Startup Changes:
  • VMs created in TrueNAS 25.04 (pre-25.04.2) and displayed on the Containers screen no longer automatically start on system boot to prevent conflicts with VMs on the Virtual Machines screen. See Containers and Virtual Machines for more information.

See the 25.10 Major Features and Full Changelog for more information.

Notable changes since 25.10-RC.1:

• Samba version updated from 4.21.7 to 4.21.9 for security fixes (4.21.8 Release Notes | 4.21.9 Release Notes)
• Improves ZFS property handling during dataset replication (NAS-137818). Resolves issue where the storage page temporarily displayed errors when receiving active replications due to ZFS properties being unavailable while datasets were in an inconsistent state.
• Fixes “Failed to load datasets” error on Datasets page (NAS-138034). Resolves issue where directories with ZFS-incompatible characters (such as [) caused the Datasets page to fail by gracefully handling EZFS_INVALIDNAME errors.
• Fixes zvol editing and resizing failures (NAS-137861). Resolves validation error “inherit_encryption: Extra inputs are not permitted” when attempting to edit or resize VM zvols through the Datasets interface.
• Fixes VM disk export failure (NAS-137836). Resolves KeyError when attempting to export VM disks through the Devices menu, allowing successful disk image exports.
• Fixes inability to remove transfer speed limits from SSH replication tasks (NAS-137813). Resolves validation error “Input should be a valid integer” when attempting to clear the speed limit field, allowing users to successfully remove speed restrictions from existing replication tasks.
• Fixes Cloud Sync task bandwidth limit validation (NAS-137922). Resolves “Input should be a valid integer” error when configuring bandwidth limits by properly handling rclone-compatible bandwidth formats and improving client-side validation.
• Fixes NVMe-oF connection failures due to model number length (NAS-138102). Resolves “failed to connect socket: –111” error by limiting NVMe-oF subsystem model string to 40 characters, preventing kernel errors when enabling NVMe-oF shares.
• Fixes application upgrade failures with validation traceback (NAS-137805). Resolves TypeError “’error’ required in context” during app upgrades by ensuring proper Pydantic validation error handling in schema construction.
• Fixes application update failures due to schema validation errors (NAS-137940). Resolves “argument after ** must be a mapping” exceptions when updating apps by properly handling nested object validation in app schemas.
• Fixes application image update checks failing with “Connection closed” error (NAS-137724). Resolves RuntimeError when checking for app image updates by ensuring network responses are read within the active connection context.
• Fixes AMD GPU detection logic (NAS-137792). Resolves issue where AMD graphics cards were not properly detected due to incorrect kfd_device_exists variable handling.
• Fixes API backwards compatibility for configuration methods (NAS-137468). Resolves issue where certain API endpoints like network.configuration.config were unavailable in the 25.10.0 API, causing “[ENOMETHOD] Method ‘config’ not found” errors when called from scripts or applications using previous API versions.
• Fixes console messages display panel not rendering (NAS-137814). Resolves issue where the console messages panel appeared as a black, unresponsive bar by refactoring the filesystem.file_tail_follow API endpoint to properly handle console message retrieval.
• Fixes unwanted “CronTask Run” email notifications (NAS-137472). Resolves issue where cron tasks were sending emails with subject “CronTask Run” containing only “null” in the message body.

Click here to see the full 25.10 changelog or visit the TrueNAS 25.10.0 (Goldeye) Changelog in Jira.

These are ongoing issues that can affect multiple versions in the 25.10 series.
When resolved, issues move to Notable Changes for the appropriate release.

• NVMe over TCP is incompatible with VMware ESXi environments (NAS-137372). TrueNAS 25.10 uses the Linux kernel NVMe over TCP target driver, which lacks support for fused commands required by VMware ESXi. This is an upstream kernel limitation that prevents path initialization in ESXi environments.

• Two-Factor Authentication (2FA) can fail during daylight saving time transitions (NAS-138200). Systems with two-factor authentication configured can experience login failures for approximately one hour during daylight saving time transitions when clocks move backward. North American users should be aware of this issue ahead of the upcoming DST transition on November 2, 2025. The authentication system resolves automatically once the duplicated hour passes.

See the latest status on Jira for public issues discovered in 25.10 that are being resolved in a future TrueNAS release.

See the Release Notes section of the TrueNAS forum for ongoing updates about known issues, investigations, and statistics about TrueNAS releases.

• The TrueNAS REST API was deprecated in TrueNAS 25.04. Full removal of the REST API is planned for TrueNAS 26.04.

  TrueNAS (25.04 and later) uses a versioned JSON-RPC 2.0 over WebSocket API. API versions are numbered in conjunction with TrueNAS version releases.

  The API documentation provides information about supported API methods and events. Documentation is included for all API versions supported by the current TrueNAS release and defaults to the latest supported API. Use the dropdown to view documentation for different supported API versions.

  Advanced users can interact with the TrueNAS API to perform management tasks using the TrueNAS API Client as an alternative to the TrueNAS web UI. This websocket client provides the command line tool midclt and allows users to communicate with middleware using Python by making API calls. The client can connect to the local TrueNAS instance or to a specified remote socket.

  You can access TrueNAS API documentation in the web interface by clicking laptop My API Keys on the top right toolbar account_circle user settings dropdown menu to open the User API Keys screen. Click API Docs to view API documentation.

• NVIDIA GPU Compatibility: TrueNAS 25.10 switches to open GPU kernel drivers that are incompatible with legacy NVIDIA GPUs (Pascal, Maxwell, Volta architectures). See NVIDIA GPU Support for compatibility details.

• Virtual Machine Startup Changes: VMs created in TrueNAS 25.04 (pre-25.04.2) and displayed on the Containers screen no longer automatically start on system boot to prevent conflicts with VMs on the Virtual Machines screen. See Containers and Virtual Machines for more information.

• Active Directory AUTORID IDMAP Backend Removal: TrueNAS 25.10 removes this option to improve consistency across multi-server environments (NAS-136630). Existing configurations using AUTORID are automatically migrated to RID during upgrade. Users should review their ACLs and permissions after upgrade and might need to reconfigure them in some edge cases.

• TrueNAS 25.10 removes the built-in SMART test scheduling and monitoring interface to improve user flexibility for disk monitoring. The smartmontools binaries remain installed and continue to be used internally by TrueNAS, ensuring that existing third-party scripts and monitoring tools continue to work unchanged. Users seeking advanced SMART monitoring can install the “Scrutiny” app from the TrueNAS catalog, which offers superior disk health tracking with historical data storage, customizable alerts, and automatic drive detection. TrueNAS maintains monitoring of critical disk health indicators and automatically migrates existing scheduled SMART tests to cron tasks during upgrade. See Disk Management for more information on the SMART monitoring transition.

• TrueNAS 25.10 removes the Certificate Authority (CA) functionality that allowed TrueNAS to create and sign certificates. Users can continue to manage certificates by creating Certificate Signing Requests (CSRs) to be signed by external certificate authorities or and importing certificates that have been signed by external CAs or directory services. These alternatives provide the certificate management capabilities most users need while ensuring proper certificate validation through established certificate authorities.

• TrueNAS 25.10 improves SMB share configuration by displaying only options relevant to each purpose-based preset. Existing shares that previously used the “No Preset” option are automatically migrated to the “Legacy Share” preset during upgrade. New shares cannot access legacy configuration options. The SMB recycle bin feature is no longer available for new shares due to security and usability concerns. For file recovery and versioning, use ZFS snapshots, which provide more reliable and predictable data protection. See Legacy Share Settings for more information.

• Pool usage, disk temperature, and related metrics can have a short delay of no more than 10 minutes before displaying. This is typically seen when TrueNAS boots or in situations where the reporting system restarts.

TrueNAS Enterprise

Virtual Machines are now “Enterprise ready” with support for TrueNAS Enterprise High Availability (HA) systems and failover (NAS-136509).

• The Enable Secure Boot option is added to virtual machine configuration screens (NAS-136466).

• Virtual machines created in 25.04 (pre-25.04.2) and displayed on the Containers screen do not automatically start on system boot to prevent conflicts with VMs on the Virtual Machines screen that might use the same zvols (NAS-136946).

• Virtual machines created in 25.04.0 or 25.04.1 using the Instances (now Containers) screen can be migrated to conventional VMs in 25.10 and later using the process described in the Migrating Containers VMs tutorial.

• Resolves ZFS ARC memory management conflicts that were causing out-of-memory crashes in Virtual Machines due to memory fragmentation issues (NAS-135499).

• TrueNAS 25.10 adds an option to automatically migrate existing applications when changing apps pool locations (NAS-135720). See Migrating Existing Applications for details.
• 25.10 supports configuring external container registry mirrors as alternative sources for Docker images (NAS-136553). See PD-2125 for more information.
• Includes the NVIDIA open GPU kernel module drivers. These drivers work with Turing and later GPUs. Earlier architectures (Pascal, Maxwell, Volta) are not compatible. See NVIDIA GPU Support for more information.
• Fixes the NVIDIA GPU-related error “RenderError: Expected [uuid] to be set for GPU in slot” (NAS-134152).
• Fixes a bug to reenable available update notifications for custom apps (NAS-135124).

TrueNAS Apps Market

Your source for general apps documentation, a browsable catalog, and individual app resources.

TrueNAS 25.10 changes how disk health monitoring works, transitioning from built-in SMART test scheduling to a flexible approach that better serves modern storage environments.

• SMART test scheduling was built into the TrueNAS UI
• Tests were configured through Data Protection Tasks screens
• SMART test results appeared on the Storage Dashboard and individual disk screens

• SMART test scheduling UI is removed
• SMART monitoring is handled through dedicated applications or user-managed scripts
• TrueNAS continues to automatically monitor critical disk health indicators
• The smartmontools binaries remain installed and functional
• Drive temperature monitoring uses the enhanced drivetemp kernel module, extended to include SCSI/SAS disk temperatures

This transition addresses several limitations:

1. Modern Storage Realities: Traditional SMART tests (short and long) designed for mechanical hard drives are less relevant for SSDs and NVMe drives, which now represent an increasing percentage of deployments. These devices focus on different health metrics like write endurance rather than mechanical wear patterns.

2. Flexibility: The previous system was restrictive and difficult to customize for advanced users.

3. Reliability: The integrated SMART test scheduler had persistent bugs and maintenance challenges. Scheduled tests could produce false positives and were difficult to troubleshoot.

4. Better Tools Available: Dedicated monitoring applications like Scrutiny provide superior disk health tracking with historical data storage, customizable alerts, and automatic drive detection.

TrueNAS continues to run continuous background monitoring that periodically polls SMART attributes from all drives. The system automatically detects and alerts on critical disk health indicators:

• Uncorrected read, write, and verify errors
• SMART self-test failures
• Critical SMART attributes that indicate imminent drive failure
• Drive temperatures using the enhanced drivetemp kernel module

These automatic alerts ensure critical disk health issues are reported immediately without additional monitoring applications.

TrueNAS 25.10 provides multiple options for monitoring disk health.

The Disk Health widget on the Storage Dashboard provides quick access to temperature monitoring and disk performance metrics:

• Displays disk temperature-related alerts and temperature ranges (highest, lowest, average)
• View Disks opens the Storage > Disks screen
• View Disk Reports opens the Reporting > Disk screen with historical disk I/O performance and temperature data

The Scrutiny app provides comprehensive disk health monitoring. It automatically detects all system drives and offers a clean web interface that displays SMART status, temperature, capacity, and power-on time at a glance. Scrutiny also tracks historical data and supports configurable alert thresholds to help identify potential drive issues early.

Install Scrutiny from the TrueNAS Apps catalog. See the Scrutiny app documentation for installation and configuration details.

During the 25.10 upgrade, TrueNAS automatically migrates existing scheduled SMART tests to cron tasks, preserving your test schedules and intervals.

View and manage these migrated tests at System > Advanced Settings > Cron Jobs.

You can edit, disable, or delete these cron jobs as needed.

The smartmontools binaries (smartctl, smartd) remain installed and continue to function normally. Existing scripts or third-party monitoring tools that invoke smartctl continue to work without modification.

TrueNAS 25.10 introduces support for NVIDIA open GPU kernel module drivers, enabling compatibility with the latest NVIDIA graphics cards including the newest Blackwell architecture. This driver update ensures support for modern GPU acceleration workloads in TrueNAS Apps and Containers.

The open GPU kernel drivers are compatible with Turing architecture and later GPUs, which includes GTX 16-series cards and all RTX series cards. The new NVIDIA Blackwell (RTX 50-series) chips require the nvidia-open driver to function, as this driver leverages the built-in NVIDIA GSP (GPU System Processor).

Users with compatible hardware can enable TrueNAS to install NVIDIA drivers. See the TrueNAS Apps Market for installation instructions.

GPUs based on earlier architectures, including Pascal (GTX 10-series, Quadro P-series), Maxwell (GTX 700 and 900-series), and Volta (GTX Titan V) are not supported by the NVIDIA open drivers. This is because these older GPUs lack the required GSP component.

Users with incompatible legacy cards can still utilize them by deploying a TrueNAS Virtual Machine and isolating the GPU to it. This approach involves creating a VM, isolating the legacy GPU to that VM, installing the proprietary NVIDIA driver within the VM environment, and running GPU workloads from within the virtual machine. However, this workaround requires a secondary GPU (such as integrated Intel graphics or an IPMI console) to handle system display duties, as isolating the only GPU in the system would leave TrueNAS without console access.

Depending on the specific system configuration, migrating from a FreeBSD-based TrueNAS version can be a straightforward or complicated process. See the Migration articles for cautions and notes about differences between each software and the migration process.

TrueNAS Enterprise

TrueNAS Enterprise customers with High Availability (HA) or Non-HA TrueNAS Hardware should consult with TrueNAS Enterprise Support for assistance before attempting to migrate.

Customers who purchase TrueNAS hardware or that want additional support must have a support contract to use TrueNAS Support Services. The TrueNAS Community forums provides free support for users without a TrueNAS Support contract.

TrueNAS Customer Support
Support Portal	https://support.ixsystems.com
Email	support@ixsystems.com
Telephone and Other Resources	https://www.ixsystems.com/support/

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

*TrueNAS 25.10 and later includes the NVIDIA open GPU kernel module drivers. These drivers work with Turing and later GPUs. Earlier architectures (Pascal, Maxwell, Volta) are not compatible. See NVIDIA GPU Support for more information.

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.3.0) are listed below:

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