TrueNAS CORETrueNAS CORE Version Documentation
This content follows the TrueNAS CORE 13.0 releases. Use the Product and Version selectors above to view content specific to different TrueNAS software or major version.

Creating Pools

TrueNAS uses ZFS data storage pools to efficiently store and protect data.

Storage pools are attached drives organized into virtual devices (vdevs). ZFS and TrueNAS periodically reviews and “heals” whenever a bad block is discovered in a pool. Drives are arranged inside vdevs to provide varying amounts of redundancy and performance. This allows for high performance pools, pools that maximize data lifetime, and all situations in between.

Review Storage Needs

It is strongly recommended that you review the available system resources and plan the storage use case before creating a storage pool.

  • When storing critical information, more drives allocated to the pool increases redundancy.
  • Maximizing total available storage at the expense of redundancy or performance means allocating large volume disks and configuring the pool for minimal redundancy.
  • Maximizing pool performance means installing and allocating high-speed SSD drives to the pool.

Determining your specific storage requirements is a critical step before creating a pool.

Creating a Pool

To create a new pool, go to Storage > Pools and click ADD. The Create or Import Pool screen of the pool creation screens displays. Select Create new pool and click CREATE POOL to open the Pool Manager.

Create Pool Manager
Figure 1: Create Pool Manager

To begin, enter a name for the pool in Name. Do not include spaces in the pool name as this could cause problems with other functions.

Encryption algorithms are available as an option for maximizing data security. This also complicates how data is retrieved and risks permanent data loss! Refer to the Encryption article for more details and decide if encryption is necessary for your use case before setting any encryption options.

Next, configure the virtual devices (vdevs) that make up the pool.

Suggested Layout

Clicking SUGGEST LAYOUT allows TrueNAS to review all available disks and populate the primary data vdevs with identically sized drives in a balanced configuration between storage capacity and data redundancy. To clear the suggestion, click RESET LAYOUT.

To manually configure the pool, add vdevs according to your use case. Select the Disk checkboxes and click the   to move the disks into the Data VDevs list.

Warning: USB-connected disks might report their serial numbers inaccurately, making them indistinguishable from each other.

Vdev Types

Pools have many different kinds of vdevs available. These store data or enable unique features for the pool:

Standard vdev for primary storage operations. Each storage pool requires at least one data vdev. Data vdev configuration typically affects how the other kinds of vdevs are configured.

A Data VDev with disks is duplicated by clicking REPEAT. When more disks are available and equal in size, the REPEAT button creates another vdev with an identical configuration called a mirror of vdevs.

When even more same-size disks are available, you can create multiple copies of the original vdev.

Don’t have multiple data vdevs with different numbers of disks in each vdev. This complicates and limits the pool capabilities.
ZFS L2ARC read-cache used with fast devices to accelerate read operations. You can add or remove this after creating the pool.
ZFS LOG device that improves synchronous write speeds. You can add or remove this after creating the pool.

Hot Spare are drives reserved to insert into Data vdevs when an active drive fails. Hot spares are temporarily used as replacements for failed drives to prevent larger pool and data loss scenarios.

When a failed drive is replaced with a new drive, the hot spare reverts to an inactive state and is available again as a hot spare.

When the failed drive is only detached from the pool, the temporary hot spare is promoted to a full data vdev member and is no longer available as a hot spare.

Special Allocation class used to create Fusion Pools for increased metadata and small block I/O performance.
Dedup vdevs store ZFS de-duplication. Requires allocating X GiB for every X TiB of general storage. For example, 1 GiB of Dedup vdev capacity for every 1 TiB of Data vdev availability.

To add a different vdev type during pool creation, click ADD VDEV and select the type. Select disks from Available Disks and use the   (right arrow) next to the new VDev to add it to that section.

Vdev Layout

Disks added to a vdev arrange in different layouts, according to the specific pool use case.

Adding multiple vdevs with different layouts to a pool is not supported. Create a new pool when a different vdev layout is required. For example, pool1 has a data vdev in a mirror layout, so create pool2 for any raid-z vdevs.

Each disk is used to store data. Requires at least one disk and has no data redundancy.

Never use a Stripe type vdev to store critical data! A single disk failure results in losing all data in the vdev.
Data is identical in each disk. Requires at least two disks, has the most redundancy, and the least capacity.
Uses one disk for parity while all other disks store data. Requires at least three disks.
Uses two disks for parity while all other disks store data. Requires at least four disks.
Uses three disks for parity while all other disks store data. Requires at least five disks.

The Pool Manager suggests a vdev layout from the number of disks added to the vdev. For example, if two disks are added, TrueNAS automatically configures the vdev as a mirror, where the total available storage is the size of one added disk while the other disk provides redundancy.

Mirrored Vdev
Figure 3: Mirrored Vdev

To change the vdev layout, open the Data VDevs list and select the desired layout.

Related Pool Articles

Related Dataset Articles