TrueNAS CORETrueNAS CORE Nightly Development Documentation
This content follows experimental early release software. Pre-release software is intended for testing purposes only.
Use the Product and Version selectors above to view content specific to a stable software release.

Adding Zvols

A ZFS Volume (Zvol) is a dataset that represents a block device. These are needed when configuring an iSCSI Share.

To create a zvol in a pool, go to Storage > Pools then click   and Add Zvol.

Options

StoragePoolsCreateZvol

To quickly create a Zvol with the default options, enter a name for the Zvol, a size, and click SAVE.

See Zvols Screen for more information on zvol settings.

Setting Zvol Block Sizes

To set the zvol block size, click ADVANCED OPTIONS on the ADD ZVOL screen. This adds the Block Size setting near the bottom of the screen. Select that option that suits the use case or uses the information below to help determine the correct setting to use.

Optimal Zvol Block Sizes

TrueNAS automatically recommends a space-efficient block size for new zvols. This table shows the minimum recommended volume block size values. To manually change this value, use the Block size dropdown list.

ConfigurationNumber of DrivesOptimal Block Size
MirrorN/A16k
Raidz-1316k
Raidz-14/532k
Raidz-16/7/8/964k
Raidz-110+128k
Raidz-2416k
Raidz-25/632k
Raidz-27/8/9/1064k
Raidz-211+128k
Raidz-3516k
Raidz-36/732k
Raidz-38/9/10/1164k
Raidz-312+128k

Additional tuning might be required for optimal performance, depending on the workload. iXsystems engineers are available to assist Enterprise customers with tuning their TrueNAS hardware. The workload tuning chapter of the OpenZFS handbook is also a good resource.

Managing Zvols

To see options for an existing zvol, click next to the desired zvol in Storage > Pools:

Use Delete zvol to remove the zvol from TrueNAS.

Deleting zvols can result in unrecoverable data loss! Be sure that any critical data is moved off the zvol or is otherwise obsolete.
Deleting a zvol also deletes all snapshots of that zvol. Use Edit Zvol to open the zvol creation form to change the previously saved settings. Similar to datasets, a zvol name cannot be changed. Use Create Snapshot to take a single current-point-in-time image of the zvol and save it to Storage > Snapshots. A snapshot name is suggested in Name along with an extra option to make the snapshot Recursive is available.

When the selected zvol is cloned from an existing snapshot, Promote Dataset is available. When a clone is promoted, the original volume becomes a clone of the clone, making it possible to delete the volume that the clone was created from. Otherwise, a clone cannot be deleted while the original volume exists.

When the zvol is created with encryption enabled, additional Encryption Actions are displayed.