TrueNASTrueNAS Stable Version Documentation
This content follows TrueNAS 24.10 (Electric Eel) releases. Use the Product and Version selectors above to view content specific to a different software release.

CORE to SCALE Migrations

This section provides information and instructions for TrueNAS CORE users wanting to migrate to SCALE.

TrueNAS users wanting to migrate from the latest FreeBSD-based 13.0-U6 or 13.3 CORE release to the Linux-based TrueNAS version 24.10 or later can migrate to 24.04 and earlier using the UI update process, but must clean install if migrating to later releases. Attempting to migrate directly to 24.10 or later using the UI is not supported.

TrueNAS community users can download a copy of the iso for the latest maintenance release of the target major version, then follow the migration instructions in Performing a Clean Install or use the UI update screen or download a manual update file then follow the instructions in Updating to 24.04 to move from the FreeBSD-based to the Linux-based version of TrueNAS.

Linux treats device names differently than FreeBSD so please read Component Naming for more information.

After migration, review each area of the UI that was previously configured in CORE.

Migration Articles

  • Preparing to Migrate: Guides CORE users through preparation elements and steps before beginning the one-way CORE to SCALE migration process.

    • Migrating TrueNAS CORE to SCALE: Provides instructions on migrating from TrueNAS CORE to SCALE. Migration methods include using an ISO or manual update file.

      • Enterprise HA Migrations: Discusses migrating a TrueNAS CORE High Availability (HA) system to SCALE.

        • Component Naming: Provides information on disk and interface naming changes related to the change from FreeBSD storage and sharing in CORE to Linux in TrueNAS SCALE.