(408) 943-4100               V   Commercial Support

Pool Import

  3 minute read.

Last Modified 2021-04-01 11:11 EDT

This procedure only applies to disks with a ZFS storage pool. To import disks with different file systems, see Import Disk.

ZFS pool importing works for pools that were exported or disconnected from the current system, created on another system, and pools to reconnect after reinstalling or upgrading the TrueNAS system. To import a pool, go to Storage > Pools > ADD.

When physically installing ZFS pool disks from another system, use the zpool export poolname command in the command line or a web interface equivalent to export the pool on that system. Shut that system down 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.

There are two kinds of pool imports, standard ZFS pool imports and ZFS pools with legacy GELI encryption.

Standard ZFS Pools

Select Import Existing Pool and click NEXT.

StoragePoolsAddImport

The wizard asks if the pool has legacy GELI encryption.

StoragePoolsAddImportNoGELI

Select No, continue with import and click NEXT.

TrueNAS detects any pools that are present but unconnected.

StoragePoolsAddImportZFSPool

Choose the ZFS pool to import and click NEXT.

Review the Pool Import Summary and click IMPORT.

StoragePoolsAddImportZFSPoolSummary

Encrypted GELI Pools

Importing a GELI-encrypted pool requires using the encryption key file and passphrase to decrypt the pool before importing. When a pool cannot be decrypted, it cannot be re-imported after a failed upgrade or lost configuration, and the data is irretrievable. Always have a copy of the pool GELI key file and passphrase available.

Select Import Existing Pool and click NEXT.

StoragePoolsAddImport

The wizard asks if the pool has legacy GELI encryption. Select Yes, decrypt the disks and review the decryption options.

StoragePoolsAddImportGELIPresentDecrypt

Make sure the Disks selection shows the encrypted disks and partitions that are part of the incoming pool. Apply the GELI encryption key file by clicking Choose File and uploading the file from your local system.

StoragePoolsAddImportGELIPresentDecryptKeyFile

When a passphrase is also present, enter it in the Passphrase field. Click Next and wait for the disks to decrypt.

When the disks are decrypted, select the GELI pool to import.

StoragePoolsAddImportGELIPresentDecryptPool

Review the Pool Import Summary and click IMPORT.

StoragePoolsAddImportGELIPresentDecryptPoolSummary

GELI encrypted pools show in Storage > Pools as (Legacy Encryption).

StoragePoolsLegacyGELI

Back Up the Pool Key

For security reasons, encrypted pool keys do not save to a configuration backup file. When TrueNAS is installed to a new device and restored with a saved configuration file, keys for encrypted disks are not present and the system does not request them.

To correct this, export the encrypted pool in Storage > Pools with > Export/Disconnect. Do not set Destroy data on this pool?. Now import the pool again. During the import, add the encryption keys as described previously.