Migrating Data to TrueNAS from Third-Party Solutions

Every NAS user has a unique storage setup and requirements. The following are general recommendations and options for migrating data into TrueNAS from third party storage solutions.

SMB Migration Using Syncthing

Users migrating data from an existing third-party NAS solution to TrueNAS 24.04 (Dragonfish) can do so using the Syncthing Enterprise application to mount the source with a remote SMB share that preserves metadata.

Read full post gdoc_arrow_right_alt

Preparing for TrueNAS UI Configuration

Users installing and configuring TrueNAS on their own servers should follow the instructions in this article to prepare for their deployment.

For support or assistance refer to the TrueNAS community forums, Discord, or the tutorials included in the TrueNAS Documentation Hub.

If you are not the administrator responsible for network access in your company, contact your network administrator for assistance. If your company obtains network hardware and support from an Internet or cable service provider, contact them for assistance with where to obtain this information.

Read full post gdoc_arrow_right_alt

Preparing for TrueNAS UI Configuration (Enterprise)

TrueNAS Enterprise

TrueNAS Enterprise customers, or those that purchased systems and service contracts from iXsystems, should use the information in this article to prepare for their TrueNAS system deployments.

The TrueNAS Enterprise Support department provides assistance with the configuration areas documented in this section.

Contacting Support

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

Read full post gdoc_arrow_right_alt

Preparing for TrueNAS UI Configuration (Home Users)

Users installing and configuring TrueNAS on their home server should follow the instructions in this article to prepare for their deployment.

For support or assistance refer to the TrueNAS community forums, Discord, or the tutorials included in the TrueNAS Documentation Hub.

Physical Access

When in the same location as the hardware designated for the TrueNAS installation, you can connect a monitor and keyboard to the system to do the initial installation and configuration. An additional USB port is required when using a USB storage device to install TrueNAS from .iso file.

Read full post gdoc_arrow_right_alt

AFP Migration

When creating a share, do not attempt to set up the root or pool-level dataset for the share. Instead, create a new dataset under the pool-level dataset for the share. Setting up a share using the root dataset leads to storage configuration issues.

Since the Apple Filing Protocol (AFP) for shares is deprecated and no longer receives updates, it is not present in TrueNAS.

Read full post gdoc_arrow_right_alt

Import Pool

ZFS pool importing works for pools exported or disconnected from the current system, those created on another system, and for pools you reconnect after reinstalling or upgrading the TrueNAS system.

The import procedure only applies to disks with a ZFS storage pool.
Do I need to do anything different with disks installed on a different system? When physically installing ZFS pool disks from another system, use the zpool export poolname command in the Linux command line or a web interface equivalent to export the pool on that system. Shut down that system and move the drives to the TrueNAS system. Shutting down the original system prevents an in use by another machine error during the TrueNAS import.

To import a pool, go to the Storage Dashboard and click Import Pool at the top of the screen.

Read full post gdoc_arrow_right_alt

Migrating MinIO Data from Previous TrueNAS Versions (Deprecated)

Due to the interaction between the TrueNAS, Minio, and FreeBSD software lifecycles, the Minio plugin does not generally deploy in TrueNAS 13.0 nor is full data migration of MinIO data from end of life (EoL) deployments of MinIO possible. Users are encouraged to pursue a manual backup and restore strategy before attempting to move to TrueNAS 24.04 or newer. These versions provide fully maintained, and updatable MinIO applications.

Read full post gdoc_arrow_right_alt

Preparing to Migrate

Migrating TrueNAS from FreeBSD- to Linux-based versions is a one-way operation. Attempting to activate or roll back to a FreeBSD-based TrueNAS boot environment can break the system.

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

Read full post gdoc_arrow_right_alt

Community Migrations

Migration Overview

This article provides information and instructions for migrating non-Enterprise FreeBSD-based TrueNAS versions (13.0 or 13.3) to Linux-based TrueNAS (22.12 and later).

TrueNAS Enterprise

Read full post gdoc_arrow_right_alt

Enterprise Migrations

TrueNAS Enterprise

TrueNAS Enterprise customers with High Availability (HA) or Non-HA TrueNAS Hardware should consult with TrueNAS Enterprise Support for assistance before attempting to migrate.

The process requires:

  • Backing up critical data.
  • An extended maintenance window.
  • Executing the migration process in a precise order.
  • Additional system configuration to update network interfaces and add new administrator accounts.

Review the Migration Preparation article to see detailed notes and caveats about the migration process.

Read full post gdoc_arrow_right_alt