Adding and Managing Datasets

A TrueNAS dataset is a file system within a data storage pool. Datasets can contain files, directories, and child datasets, and have individual permissions or flags.

Datasets can also be encrypted. In TrueNAS 22.12.3 or later, the TrueNAS UI requires encryption for child datasets created in encrypted parent datasets, but you can change the encryption type from key to passphrase. You can create an encrypted dataset if the parent is not encrypted and set the type as either key or passphrase.

Read full post gdoc_arrow_right_alt

Managing SMB Shares

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.

To access SMB share management options, go to Shares and locate the Windows (SMB) Shares widget. The widget lists configured SMB shares, but it is not the complete list. To see a complete list of shares, click on Windows (SMB) Shares launch header to open the Shares > SMB screen. The more_vert dropdown list to the right of each share shows four options that open other screens or dialogs that provide access to share settings.

Read full post gdoc_arrow_right_alt

SMB Shares Screens

Windows (SMB) Shares Widget

If you have not added SMB shares to the system, the SMB widget shows text stating general information about the Windows (SMB) Shares until a share is added.

Read full post gdoc_arrow_right_alt

Datasets

The Datasets screen and widgets show information about datasets and zvols, provide access to data management functions, indicate the dataset roles, list the services using the dataset, show encryption status, and list permissions for datasets. The screen focuses on managing data storage, including user and group quotas, snapshots, and other data protection measures.

Datasets Screen

The Datasets screen shows No Datasets and a Create Pool button until you add a pool and the first root dataset.

Read full post gdoc_arrow_right_alt

Permissions

TrueNAS offers two Access Control List (ACL) types: POSIX (the TrueNAS default) and NFSv4. For a more in-depth explanation of ACLs and configurations in TrueNAS, see our ACL Primer.

The Dataset Preset option on the Add Dataset screen sets the ACL type applied for SMB shares, apps, multi-protocol shares, and general-use datasets.

The ACL Type setting in the Advanced Options on both the Add Dataset and Edit Dataset screens, determines the ACL presets available on the ACL Select a preset ACL window. It also determines which permissions editor screens you see after you click the edit edit icon on the Dataset Permissions widget.

Read full post gdoc_arrow_right_alt

Setting Up Permissions

TrueNAS provides basic permissions settings and an access control list (ACL) editor to define dataset permissions. ACL permissions control the actions users can perform on dataset contents and shares.

An Access Control List (ACL) is a set of account permissions associated with a dataset that applies to directories or files within that dataset. TrueNAS uses ACLs to manage user interactions with shared datasets and creates them when users add a dataset to a pool.

ACL Types in TrueNAS

TrueNAS offers two ACL types: POSIX and NFSv4. For a more in-depth explanation of ACLs and configurations in TrueNAS, see our ACL Primer.

Read full post gdoc_arrow_right_alt