TrueNAS SCALETrueNAS SCALE Version Documentation
This content follows the TrueNAS SCALE 24.04 (Dragonfish) releases. Use the Product and Version selectors above to view content specific to different TrueNAS software or major version.

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 13.0-U6.1 (or later) release before attempting to migrate from CORE to SCALE.

TrueNAS Enterprise

SCALE Bluefin deprecates and SCALE Cobia removes the built-in DDNS, OpenVPN server and client, rsync, S3, and TFTP services. The WebDAV service and share feature are also deprecated in Bluefin and removed in Cobia. New applications are available in SCALE Bluefin to serve as replacements for the functions provided by these services.

To avoid any potential service outages, Enterprise customers with licensed TrueNAS systems are prevented from upgrading from SCALE 22.12.3 (or later) to SCALE 23.10 unless the deprecated services have been replaced and/or disabled. Enterprise customers can contact iXsystems Support for assistance migrating from deprecated services.

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 SCALE 22.02 and removed in 22.12.