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

CORE to SCALE Migrations

  3 minute read.

Last Modified 2024-03-19 08:38 EDT

This 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.

Customers who purchase iXsystems hardware or that want additional support must have a support contract to use iXsystems Support Services. The TrueNAS Community forums provides free support for users without an iXsystems Support contract.

iXsystems Customer Support
Support Portalhttps://support.ixsystems.com
Emailsupport@ixsystems.com
Telephone and Other Resourceshttps://www.ixsystems.com/support/

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.

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

To migrate from CORE to SCALE Cobia, first upgrade to and migrate from the latest CORE release to the latest release of SCALE 22.12 (Bluefin). While running SCALE Bluefin, take the necessary steps to transition from these deprecated services to the applications that replace them, then upgrade to SCALE 23.10 (Cobia). The replacement applications are available in SCALE 22.12 and 23.10.

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.

Migration Articles