TrueNAS SCALE Documentation Archive
This content follows the TrueNAS SCALE 22.12 (Bluefin) releases. Archival documentation is provided for reference only and not actively maintained.
Use the Product and Version selectors above to view content specific to different TrueNAS software or major versions.
Migrating Instructions
2 minute read.
Last Modified 2024-03-19 08:47 EDTThis section provides information and instructions for CORE users wanting to migrate to SCALE.
TrueNAS Enterprise
High Availability (HA) systems cannot migrate directly from CORE to SCALE.
Enterprise customers with HA systems should contact iXsystems Support before attempting any migration.
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 13.0-Ux release before attempting to migrate from CORE to SCALE.
Linux treats device names differently than FreeBSD so please read Component Naming for more information.
The ZFS flag feature merged into the TrueNAS fork of OpenZFS for developers to test and integrage with other parts of the system on June 29,2021 is also removed. Please read ZFS Feature Flags Removed for details on this change.
After migration, it is strongly recommended to review each area of the UI that was previously configured in CORE.
- Preparing to Migrate TrueNAS CORE to SCALE: Guides CORE users about elements they should prepare 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 file or a manual update file.
- Preparing to Migrate TrueNAS CORE to SCALE (Enterprise HA): Provides information for CORE Enterprise (HA) users planning to migrate to SCALE and what you need to know and have ready before beginning the one-way process.
- Migrating TrueNAS CORE to SCALE (Enterprise HA): 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 information on the removal of the ZFS feature flag merged into OpenZFS on June 29, 2021.