Migrating TrueNAS CORE to SCALE (Enterprise HA)

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.

iXsystems Support

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.

Contact MethodContact Options
TelephoneMonday - Friday, 6:00AM to 6:00PM Pacific Standard Time:

US-only toll-free: 1-855-473-7449 option 2
Local and international: 1-408-943-4100 option 2
TelephoneAfter Hours (24x7 Gold Level Support only):

US-only toll-free: 1-855-499-5131
International: 1-408-878-3140 (international calling
rates apply)

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.

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.

Customers with CORE Enterprise High Availability (HA) systems that want to migrate to SCALE cannot directly migrate the system. Instead, the process is to clean install SCALE on the system and reimport the storage pools. Due to software differences between CORE and SCALE, an HA system with CORE installed cannot directly migrate to SCALE.

Moving an HA system from CORE to SCALE

First, back up your data storage and export your pools to the server.

Review the list of preparation steps in Preparing for SCALE UI Configuration (Enterprise) and gather the information you need before you begin installing SCALE.

Next, do a clean install of SCALE using the iso file. You must observe the proper sequence for controller 1 and controller 2 so the system comes up with controller 1 as the primary and controller 2 the standby controller.


After installing SCALE, configure controller 1 using the SCALE UI, configure controller 1 to the point just before you sync to peer, then power up controller 2 with SCALE already installed and at the Console setup menu screen but not configured, then on controller 1 sync to peer.

After configuring network in controller 1, import all your pools. Creating a new pool before importing pools could result in accidentally wiping disks currently used with an exported pool.