TrueNAS SCALETrueNAS Nightly Development Documentation
This content follows experimental nightly development software. Pre-release software is intended for testing purposes only.
Use the Product and Version selectors above to view content specific to a stable software release.

CORE to SCALE Migrations

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

Migrating TrueNAS from CORE to SCALE is a one-way operation. Attempting to activate or roll back to a CORE boot environment can break the system.

Upgrade your CORE system to the latest publicly-available version, 13.0-U6.2 (or 13.3 for community users), release before attempting to migrate from CORE to SCALE. See Software Releases for current recommended update paths to make sure you download and migrate to the correct SCALE version.

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.

          • ZFS Feature Flags Removed: Provides legacy information for users of a deprecated ZFS feature flag merged into TrueNAS 22.02 and removed in 22.12.