Review the TrueNAS update profile before a major-version change

Bottom line: Choose the intended release path before treating an available update as the approved target. Keep the update profile, intervening major versions and restart window in the same change request.

Source fact: what the authority says

The TrueNAS update guide describes update profiles intended for different use cases and distinguishes those profiles from major-version release trains. Its major-version guidance says to follow the upgrade path of major versions until the desired major release is reached. It warns that the Developer profile is unsuitable for production use and can expose systems to bugs. The documented update process restarts the system, so the guide advises scheduling updates when the system is idle and users are disconnected.

What the source does not establish

This article does not select the currently recommended TrueNAS release for a particular workload or approve a prerelease channel. Configuration and data recovery remain separate requirements; an available update and a completed restart do not establish workload compatibility.

Applicability questions

• What exact version and update profile are installed now?
• Which supported upgrade path reaches the proposed target?
• What services and users require a coordinated interruption window?
• Which recovery evidence and application checks must be accepted before production resumes?

DSE recommendation: controlled next steps

The following steps are DSE recommendations based on the cited source.

DSE recommends a release-path record listing the current version, proposed target and each required intermediate major version. Check the current official release and software-status references before approval. Keep the profile choice explicit rather than relying on whichever update the interface happens to display.

Have the storage owner explain why the chosen channel fits the workload’s stability requirements. Exclude the Developer branch from this production plan. Treat a test or prerelease evaluation as a different activity with its own disposable system and data restrictions.

Plan a proposed representative upgrade rehearsal against the actual service inventory. Name the SMB, NFS, iSCSI or other workload owners who must observe the result, selecting only the services actually used. Keep the recovery package and restore authority available through the organization’s separate recovery procedure.

Schedule each approved restart as a deliberate change point. Record the maintenance contact, client-disconnection plan and condition for stopping before the next version. Avoid combining unrelated storage-layout changes with the release transition merely because a maintenance window is available.

Verification and evidence

Proposed verification: inspect the effective installed version and update profile before the run, then compare each completed transition with the approved release path. Preserve the actual update and restart observations, including warnings and incomplete steps. Do not label an intermediate system finished while another required transition remains unreviewed.

After each approved stage, run the named harmless workload checks and confirm client access through the intended paths. Have the application owners record their observations separately from the updater’s completion status. Retain unresolved failures and keep the recovery decision open until the agreed service checks are accepted.

Official references

• TrueNAS — Updating TrueNAS — official product documentation; confirm the installed release and configuration.

Source review completed October 29, 2026. Recheck the official documentation and deployment-specific applicability before a production change.