TrueNAS CORETrueNAS CORE Nightly Development Documentation
This content follows experimental early release software. Use the Product and Version selectors above to view content specific to a stable software release.

13.3 Version Notes

TrueNAS CORE Logo

13.3


This page tracks the latest development roadmap and release notes for the upcoming TrueNAS CORE major version, 13.3. The latest TrueNAS CORE 13.0 version release notes are available from the TrueNAS CORE 13.0 documentation section.

TrueNAS CORE 13.3, the latest version of the most reliable and highest-quality platform for traditional primary storage use cases, continues to focus on ensuring storage reliability, stability, and security for existing users.

With this release, TrueNAS CORE is now entering a sustaining engineering phase within the TrueNAS project. Users can expect to receive maintenance updates for many years still to come.

TrueNAS CORE 13.3 will include the following updates:

TrueNAS CORE 13.3 will continue to receive bug fixes related to stability and security. These updates will ensure that 13.3 is a reliable platform for both homelab and enterprise customers, as well as a staging version for those users who wish to migrate to SCALE at a later date.

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.

To download a .tar file for installing or upgrading to a CORE 13.3 nightly version, go to https://www.truenas.com/download-truenas-core/ and click Download Future Previews. Select the latest .tar file and click Download.

Log in to the web interface and go to System > Update. Click INSTALL MANUAL UPDATE FILE. Select SAVE CONFIGURATION when prompted. Select an Update File Temporary Storage Location then click Chose File and browse to select the .tar file. Click APPLY UPDATE.

More details are available from Updating Core.

Release Schedule

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

CORE™ | Enterprise™

Previous
Current
Next
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 StageCompleted QA CyclesTypical UseDescription
NIGHTLY0DevelopersIncomplete
ALPHA1TestersNot much field testing
BETA2EnthusiastsMajor Feature Complete, but expect some bugs
RC4Home UsersSuitable for non-critical deployments
RELEASE6General UseSuitable for less complex deployments
U17Business UseSuitable for more complex deployments
U2+8Larger SystemsSuitable for higher uptime deployments

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

Upgrade Notes

  • Due to security vulnerabilities and maintainability issues, the S3 service is deprecated in TrueNAS CORE 13.0 and removed in CORE 13.3 (NAS-127694). Beginning in CORE 13.0-U6, the CORE web interface generates an alert when the deprecated service is either actively running or is enabled to start on boot. Users should migrate to a separately maintained MinIO plugin or otherwise move any production data away from the S3 service storage location before upgrading to 13.3. See the CORE 13.0 tutorial for detailed migration instructions. See also Feature Deprecations.

  • The web UI Shell is removed in CORE 13.3. Users can continue to access the shell using SSH or a physical system connection with serial cable or other direct method (NAS-124392).

  • The Plugins, Jails, and Virtual Machines features are untested and provided without support to the TrueNAS Community. Users with a critical need to use containers or virtualization solutions in production should migrate to the tested and supported virtualization features available in TrueNAS SCALE. TrueNAS Enterprise customers can contact iXsystems to schedule a TrueNAS SCALE deployment. See CORE to SCALE Migrations for more information.

Upgrade Paths

TrueNAS CORE
      flowchart LR
      A["11.3-U5"] -->|update| B["12.0-U2"]
      B -->|update| C["13.0-U6.1"]
      C -->|"(anticipated)"| D["13.3.0"]
      
TrueNAS CORE Enterprise
      flowchart LR
      A["11.3-U5"] -->|update| B["12.0-U2"]
      B -->|update| C["13.0-U6.1"]
      

Component Versions

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

ComponentVersion
FreeBSD13.3-RELEASE-1
OpenZFS2.2.3-1

New OpenZFS Feature Flags

The items listed here represent new feature flags implemented since the previous update to the built-in OpenZFS version.

Feature FlagGUIDNotes
blake3org.openzfs:blake3
block_cloningcom.fudosecurity:block_cloning
draidorg.openzfs:draiddraid is not supported in the TrueNAS CORE web interface. See TrueNAS SCALE for this feature.
head_errlogcom.delphix:head_errlog
vdev_zaps_v2com.klarasystems:vdev_zaps_v2
zilsaxattrorg.openzfs:zilsaxattr

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

13.3-BETA1 Changelog

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

May 7, 2024

iXsystems is pleased to release TrueNAS CORE 13.3-BETA1! This has software component updates and security fixes that are in the polishing phase.

Notable changes:

  • Due to security vulnerabilities and maintainability issues, the S3 service is deprecated in TrueNAS CORE 13.0 and removed in CORE 13.3 (NAS-127694). Beginning in CORE 13.0-U6, the CORE web interface generates an alert when the deprecated service is either actively running or is enabled to start on boot. Users should migrate to a separately maintained MinIO plugin or otherwise move any production data away from the S3 service storage location before upgrading to a 13.3 pre-release version. See the CORE 13.0 tutorial for detailed migration instructions. See also Feature Deprecations.

  • The web UI Shell is removed in CORE 13.3. Users can continue to access the shell using SSH or a physical system connection with serial cable or other direct method (NAS-124392).

  • The Plugins, Jails, and Virtual Machines features are untested and provided without support to the TrueNAS Community. Users with a critical need to use containers or virtualization solutions in production should migrate to the tested and supported virtualization features available in TrueNAS SCALE. TrueNAS Enterprise customers can contact iXsystems to schedule a TrueNAS SCALE deployment. See CORE to SCALE Migrations for more information.

  • Update SAMBA to version 4.19 (NAS-120600).

  • Update rsync to version 3.2.7 (NAS-124036).

  • Fix macOS Time Machine backup and snapshot issues (NAS-125197 and NAS-125218).

  • Bugfix for zettarepl memory leak (NAS-125338).

  • Allow ampersand (&) character in user email addresses (NAS-125483).

  • SNMP agent bugfix (NAS-125904).

  • Pagination offset and limit improvements for /api/v2.0/certificate (NAS-126080).

Click here for the full changelog of completed tickets that are included in the 13.3-BETA1 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.

13.3-BETA1 Ongoing Issues

TrueNAS Enterprise
We are aware of an issue impacting TrueCommand connections for High Availability (HA) systems. TrueNAS Enterprise HA customers should not upgrade to 13.3-BETA1 at this time.

Click here to see the latest information about public issues discovered in 13.3-BETA1 that are being resolved in a future TrueNAS CORE release. This list also includes issues that are not to be fixed in CORE and are resolved in TrueNAS SCALE.