TrueNAS CORETrueNAS CORE Nightly Development Documentation
This content follows experimental early release software. Use the Product and Version selectors above to view content specific to a stable software release.

Datasets Screens

Use the Storage > Pools Add Dataset screen to add a dataset to your TrueNAS. A TrueNAS dataset is a file system that is created within a data storage pool. There are two settings options, BASIC OPTIONS and ADVANCED OPTIONS. Use the basic option unless you want to customize your dataset for specific uses cases.

Add Dataset Screen

Dataset Basic Options

Add Dataset Screen
Figure 1: Add Dataset Screen

Use SUBMIT without entering settings to quickly create a dataset with the default options or after entering settings to save and create the dataset.

Name and Options

The Name and Options fields are required to create the dataset. Datasets typically inherit most of these settings from the root or parent dataset, only a dataset name is required before clicking SUBMIT.

SettingDescription
NameEnter a unique identifier for the dataset. The name cannot be changed after the dataset is created.
CommentsEnter notes about the dataset.
SyncSelect an option from the dropdown list. Select Standard uses the sync settings requested by the client software. Select Always to wait for data writes to complete, or select Disabled to never wait for writes to complete.
Compression levelSelect an option to encode information in less space than the original data occupies. It is recommended to choose a compression algorithm that balances disk performance with the amount of saved space:
lz4 is generally recommended as it maximizes performance and dynamically identifies the best files to compress.
zstd is the Zstandard compression algorithm that has several options for balancing speed and compression.
gzip options range from 1 for least compression, best performance, through 9 for maximum compression with greatest performance impact.
zle is a fast algorithm that only eliminates runs of zeroes.
lzjb is a legacy algorithm that is not recommended for use.
Enable AtimeSelect an option from the dropdown list. Inherit (off) inherits from the pool. on updates the access time for files when they are read. off disables creating log traffic when reading files to maximize performance.
EncryptionSelect Inherit (non-encrypted) to inherit the root or parent dataset encryption properties. Clear the checkmark to either not encrypt the dataset or to configure encryption settings other than those used by the root or parent dataset. See Encryption for more information on encryption.

Other Options

Use the Other Options to help tune the dataset for particular data sharing protocols:

SettingDescription
ZFS DeduplicationSelect an option to transparently reuse a single copy of duplicated data to save spacefrom the dropdown list. Options are Inherit (off), on, verify or off. Deduplication can improve storage capacity, but is RAM intensive. Compressing data is generally recommended before using deduplication. Deduplicating data is a one-way process. *Deduplicated data cannot be undeduplicated!
Case SensitivitySelect an option from the dropdown list. Sensitive assumes file names are case sensitive. Insensitive assumes file names are not case sensitive. Mixed understands both types of file names. Case sensitivity cannot be changed after the dataset is created!
Share TypeSelect an option from the dropdown list to define the type of data sharing the dataset uses to optimize the dataset for that sharing protocol. Options are Generic or SMB. AFP type shares use SMB unless directed to select Generic. The type of share cannot be changed after the dataset is created!

Dataset Advanced Options

Use ADVANCED OPTIONS to add additional dataset settings such as quota management tools, basic ACL permissions and a few additional Other Options settings fields.

Add Dataset Advanced Options
Figure 2: Add Dataset Advanced Options

Quota Settings for this dataset and/or this dataset and its child datasets

SettingDescription
Quota for this datsetEnter an integer to define the maximum allowed space for the dataset. 0 disables quotas.
Quota warning alert at, %Enter an integer to generate a warning level alert when consumed space reaches the defined percentage. By default, Inherit is selected and the dataset inherits this value from the parent dataset. Clear the checkmark to change the value.
Quota critical alert at, %Enter an integer to generate a critical level alert when consumed space reaches the defined percentage. By default, Inherit is selected and the dataset inherits this value from the parent dataset. Clear the checkmark to change the value.
Reserved space for this datasetEnter an integer to reserve additional space for datasets that contain logs which could eventually take up all the available free space. 0 is unlimited.
Add Dataset Advanced Options 2
Figure 3: Add Dataset Advanced Options 2

Other Options

Additional Other Options settings

SettingDescription
Read-onlySelect an option from the dropdown list. On prevents the dataset being modified. Off allows users accessing the dataset to modify its contents.
ExecSelect an option from the dropdown list. On allows processes to executd from within this dataset. Off prevents processes from executing in the dataset. It is recommended to set to On.
Snapshot directorySelect an option to control visibility of the .zfs directory on the dataset. Options are Visible or Invisible.
CopiesSelect an option from the dropdown list to specify the number of duplicate ZFS user data copies stored on this dataset. Choose between 1, 2, or 3 redundant data copies. This can improve data protection and retention, but is not a substitute for storage pools with disk redundancy.
Record SizeSelect an option from the dropdown list for the Logical block size in the dataset. Matching the fixed size of data, as in a database, could result in better performance.
ACL ModeSelect an option from the dropdown list to determine how chmod behaves when adjusting file ACLs. See the zfs aclmode property.
Passthrough only updates ACL entries that are related to the file or directory mode.
Restricted does not allow chmod to make changes to files or directories with a non-trivial ACL. An ACL is trivial if it can be fully expressed as a file mode without losing any access rules. Restricted is typically used to optimize a dataset for SMB sharing, but can require further optimizations. For example, configuring an rsync task with this dataset could require adding --no-perms in the Rsync task Auxiliary Parameters field.
Metadata (Special) Small Block SizeEnter an integer for the threshold block size for including small file blocks into the special allocation class (fusion pools). Blocks smaller than or equal to this value are assigned to the special allocation class while greater blocks are assigned to the regular class. Valid values are zero or a power of two from 512B up to 1M. The default size 0 means no small file blocks are allocated in the special class. Add a special class vdev to the pool before setting this property.

Edit Datasets Screen

Use the Storage > Pools Edit Dataset screen to change setting for an existing dataset. The settings are identical to the Add Dataset screens above. to access the Edit Dataset screens, click the   for a dataset and select Edit Options.

Dataset Edit Permissions Screen

Use the Storage > Pools Edit Permissions screen to change permissions settings for a parent dataset. To access the Edit Permissions screens, click the   for a dataset and select Edit Options.

Edit Permissions Screen
Figure 4: Edit Permissions Screen
SettingDescription
Dataset PathDisplays the dataset path for the selected dataset.

Owner Settings

SettingDescription
UserEither type to search for or use dropdown list to select an existing user on the system that controls this dataset. Dropdown list displays all user on the TrueNAS system.
Apply UserSelect to confirm selected user. As a check on errors, if not selected the user is not submitted.
GroupEither type to search for or use dropdown list to select an existing group on the system that controls this dataset. Dropdown list displays all user on the TrueNAS system.
Apply GroupSelect to confirm selected group. As a check on errors, if not selected the group is not submitted.

Access Settings

SettingDescription
Access ModeSelect the Read, Write and Execute checkboxes for User, Group, and Other to set the permissions levels.

Advanced Settings

SettingDescription
Apply Permissions RecursivelySelect to apply permissions recursively to all directories and files within the current dataset.
TraverseSelect to apply permissions recursively to all child datasets of the current dataset.

USE ACL Manager Screen

Click USE ACL MANAGER to open the ACL editor to further customize permissions. After selecting the Select a preset ACL radio buttons on the Create an ACL dialog, select a Default ACL Option from the dropdown list. Options are OPEN, Restricted or HOME. Or Create a custom ACL and then click CONTINUE to display the Edit ACL screen with the default permissions for the option you selected.

Edit ACL Screen Top
Figure 5: Edit ACL Screen Top
Edit ACL Screen Bottom
Figure 6: Edit ACL Screen Bottom

File Information Settings

SettingDescription
PathDisplays the dataset path for the selected dataset.
UserEither type to search for or use dropdown list to select an existing user on the system that controls this dataset. Dropdown list displays all user on the TrueNAS system.
Apply UserSelect to confirm selected user. As a check on errors, if not selected the user is not submitted.
GroupEither type to search for or use dropdown list to select an existing group on the system that controls this dataset. Dropdown list displays all user on the TrueNAS system.
Apply GroupSelect to confirm selected group. As a check on errors, if not selected the group is not submitted.

Access Control List Settings - owner@, group@ and everyone@

SettingDescription
WhoSelect from the dropdown list of options. Default for each of the three groups of settings is owner@, group@ and everyone@ but you can change this to either of these additional options User or Group. Selection modifies values displayed in other settings.
ACL TypeSelect either Allow or Deny from the dropdown list to specify how permissions apply to the value selected in Who. Select Allow to grant the specified permissions or Deny to restrict the specified permissions.
Permissions TypeSelect either Basic or Advanced from the dropdown list. Basic shows general permissions. Advanced shows each specific type of permission for finer control.
PermissionsSelect the permissions to apply to the selected value in Who. The list of permissions changes based on the value selected in Permissions Type. See Permissions for more information on permissions by permissions type (Basic and Advanced).
Flags TypeSelect the set of ACE inheritance flags to display. Options are Basic or Advanced. If Basic non-specific inheritance options show in the list. If Advanced the dropdown list shows specific inheritance settings for finer control.
FlagsSelect how this ACE applies to newly created directories and files within the dataset. If Flag Type is set to Basic options are Inherit or No Inherit. If Flag Type is set to Advanced flags are File Inherit, Directory Inherit, No Propagate Inherit, Inherit Only, or Inherited.

Use ADD ACL ITEM to add another set of the ACL permission settings.

Select Apply permissions recursively to apply the ACL settings recursively to all directories and files in the current dataset.

USE PERMISSIONS EDITOR opens the Edit Permissions screen.