# Choose the supported CORE migration route to TrueNAS 24.10 or later

> Distinguish the documented direct clean-install route from the older UI migration path and plan configuration and administrator recovery.

- Canonical URL: https://update.dsesecurity.com/updates/choose-the-supported-core-migration-route-to-truenas-24-10-or-later/
- Publisher: Detection Systems & Engineering (DSE Security)
- Author: DSE Security Editorial Team
- Published: 2026-10-30T06:04:40+00:00
- Modified: 2026-10-30T06:05:14+00:00
- Last reviewed by DSE: 2026-10-30
- Resource type: Guide
- DSE priority: Advisory
- Topics: Business Continuity, Networks & Infrastructure
- Reading time: 3 minutes

## What you need to know

Distinguish the documented direct clean-install route from the older UI migration path and plan configuration and administrator recovery.

## Potentially affected

Non-Enterprise FreeBSD-based TrueNAS 13.0 or 13.3 systems assessing migration through the TrueNAS 25.10 documentation.

## DSE recommendation

Select the documented route for the exact source and target releases before scheduling migration.

## Article

Bottom line: Choose the migration route from the actual source and target releases. Keep a direct clean install, configuration recovery and post-import administrator access in the plan instead of assuming the older UI migration path reaches every target.

## Source fact: what the authority says

The [TrueNAS 25.10 Community Migrations guide](https://www.truenas.com/docs/scale/25.10/gettingstarted/migrate/migrate-community/) requires a clean install for direct migration from CORE 13.0 or 13.3 to TrueNAS 24.10 or later; direct UI migration to those targets is unsupported. It separately documents migration to 24.04 through an update train or manual update file, followed by the normal ordered major-release update process. It warns that FreeBSD-to-Linux migration is one-way and activating an earlier FreeBSD boot environment can break the system. Importing the earlier configuration deletes the clean-install truenas_admin account and requires recreating an administrator account. For every migration method, the guide requires updating the source to the latest maintenance release of TrueNAS 13.0 or 13.3 first and checking Software Releases for the current version.

## What the source does not establish

This article selects a route from the versioned migration guide, not a statement of the newest recommended release. The guide advises TrueNAS Enterprise hardware customers to consult TrueNAS Enterprise Support before migration; application, hardware and directory dependencies remain outside this article’s route-selection scope.

## Applicability questions

- What exact CORE source release and intended target release are involved?

- Does the plan use the direct clean-install route or the separately documented older route?

- Where is the controlled configuration recovery package?

- Who will recreate and verify administrator access after the configuration import?

## DSE recommendation: controlled next steps

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

DSE recommends naming the actual source and target releases at the top of the migration plan. First confirm the required source maintenance update against the current Software Releases reference. Have another operator identify the matching route in the versioned guide. Reject a plan that assumes an older UI migration procedure reaches a later target without checking the stated boundary.

For a proposed direct migration, plan the clean installation and configuration import as distinct checkpoints. Preserve configuration and data recovery evidence under the organization’s established process before scheduling the work. Keep boot-media handling, workload dependencies and administrator recovery explicitly owned rather than relying on memory at the console.

Include an administrator-account step after the import, with a tested means of reaching the system through the approved management path. Keep the account’s authorization and secret handling separate from the configuration file. Do not describe selecting a previous FreeBSD boot environment as a harmless universal reversal plan.

Use a representative isolated system for the first route rehearsal where feasible. Select only the workloads and directory dependencies actually required by the deployment, with named owners and stopping conditions. For Enterprise systems, obtain the separate support-led plan instead of applying this Community procedure by analogy.

## Verification and evidence

Proposed verification: record each actual release, installation stage and configuration-import observation against the selected route. Confirm the intended administrator can sign in after the import and retain a redacted account-verification result. Treat a completed installer or import as a different observation from restored management access.

Run the separately approved harmless service checks with the relevant owners and preserve unexpected results. Reconcile the actual target release and remaining migration issues before returning service. Keep any recovery decision within the reviewed procedure rather than improvising an earlier-boot-environment switch to make an incomplete migration appear reversible.

## Official references

- [TrueNAS — Community Migrations](https://www.truenas.com/docs/scale/25.10/gettingstarted/migrate/migrate-community/) — official product documentation; confirm the installed release and configuration.

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

## Primary reference

- Name: TrueNAS — Community Migrations
- Authority: www.truenas.com
- URL: https://www.truenas.com/docs/scale/25.10/gettingstarted/migrate/migrate-community/
- Source publication date: Not stated by the source

## Citation and use

Preferred citation: “Choose the supported CORE migration route to TrueNAS 24.10 or later,” DSE Security, https://update.dsesecurity.com/updates/choose-the-supported-core-migration-route-to-truenas-24-10-or-later/
Publishing principles: https://update.dsesecurity.com/updates/dse-updates-editorial-methodology/
Usage and citation policy: https://update.dsesecurity.com/usage/
Copyright © 2026 Detection Systems & Engineering. All rights reserved.
