* We recommend the default Mission Critical update profile for all TrueNAS Enterprise systems.

Customers with a TrueNAS Enterprise support contract should contact TrueNAS Support before system updates. Our Support team can provide advice based on your unique requirements and help resolve any unexpected issues.

Update to the latest maintenance release of the current major version before upgrading to the next major version. You can then upgrade directly from the latest maintenance release to the latest release of the next major version.

This chart shows the basic upgrade paths between TrueNAS major versions. Depending on your use case and risk tolerance, you might prefer to delay upgrading to allow additional time for testing and stability. See the TrueNAS Software Status for version recommendations tailored to different user types from Developer to Mission Critical.

            flowchart LR
              A["11.3-U5"] -->|update| B["12.0-U8.1"]
              B -->|"update / ISO install"| C["13.0-U6.8 / 13.3-U2"]
              C -->|update| G
              C -->|ISO install| J
              D["22.02.4 (Angelfish)"] -->|update| E
              E["22.12.4.2 (Bluefin)"] -->|update| F
              F["23.10.2 (Cobia)"] -->|update| G
              G["24.04.2.5 (Dragonfish)"] -->|update| H
              H["24.10.2.4 (Electric Eel)"] -->|update| I
              I["25.04.2.6 (Fangtooth)"] -->|update| J
              J["25.10.8 (Goldeye)"] -->|"anticipated"| K
              K["TrueNAS 27.0"]
            

            flowchart LR
              A["11.3-U5"] -->|update| B
              B["12.0-U8.1"] -->|update| C
              C["13.0-U6.8"] -->|ISO install| H
              C -->|update| E
              D["23.10.2 (Cobia)"] -->|update| E
              E["24.04.2.5 (Dragonfish)"]  -->|update| F
              F["24.10.2.4 (Electric Eel)"] -->|update| G
              G["25.04.2.6 (Fangtooth)"] -->|update| H
              H["25.10.8 (Goldeye)"] -->|"anticipated"| I
              I["TrueNAS 27.0"]
            

Permitted upgrade methods are:

• update: Apply updates using the Update screen in the TrueNAS UI or install a manual update file. Not all upgrade paths support automatic updates (see chart).
• ISO install: Save your TrueNAS configuration file, perform a fresh install using an .iso file for the target version, then upload the saved configuration.

You can skip major versions using a fresh installation with configuration file restore. Before skipping versions, review release notes for each major version to identify service deprecations or significant changes that might affect your configuration. Consider upgrading incrementally through major versions with significant changes, or be prepared to manually reconfigure any incompatibilities after upgrading directly to the target version.

Documentation is actively maintained for all TrueNAS versions recommended on the TrueNAS Software Status page, with updates published alongside software releases. Each TrueNAS product has dedicated documentation sections with version selectors for navigating between releases.

When a TrueNAS version is no longer recommended for any user type, its documentation moves to the Documentation Archive. Archived documentation is read-only and receives no further updates, but remains available as a historical reference for installations that haven’t yet migrated to a supported version.