The SCALE CLI guide is a work in progress! New namespace and command documentation is continually added and maintained, so check back here often to see what is new! The acltemplate namespace provides the ability to find existing ACL templates, create new or update exiting templates, or delete a template. The web UI refers to ACL templates as presets. This namesapce does not assign ACL permissions to a dataset. The storage namespace provides access to commands to assign dataset permissions.
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. TrueNAS automatically encrypts datasets created in encrypted pools, but you can change the encryption type from key to passphrase. You can create an encrypted dataset if the pool is not encrypted and set the type as either key or passphrase.
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 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.
To access SMB share management options, go to Shares screen with the Windows (SMB) Shares widget. The widget lists SMB shares configured on but is not the full list. Each share listed includes four icons that open other screens or dialogs that provide access to share settings. To see a full list of shares, click on Windows (SMB) Shares launch to open the Sharing > SMB screen. Each share row on this screen provides access to the other screens or dialogs with share settings.
The SCALE CLI guide is a work in progress! New namespace and command documentation is continually added and maintained, so check back here often to see what is new!
Windows (SMB) Shares Widget If you have not added SMB shares to the system, the SMB widget shows No records have been added yet.
Figure 1: Windows (SMB) Share Widget without Shares Add at the top right of the widget opens the Add SMB screen where you configure SMB shares. After adding an SMB share it displays on the widget.
Figure 2: Windows (SMB) Share Widget with Shares Click on Windows (SMB) Shares launch to open the Sharing > SMB screen.
Permissions control the actions users can perform on dataset contents. TrueNAS allows using both a simple permissions manager and editing a full Access Control List (ACL) for defining dataset permissions.
To change dataset permissions, go to Storage > Pools > more_vert Edit Permissions for a dataset.
Basic Permissions Editor The Edit Permissions option allows basic adjustments to a datasets ACL.
Options The Owner section controls which TrueNAS user and group has full control of this dataset.
The SCALE CLI guide is a work in progress! New namespace and command documentation is continually added and maintained, so check back here often to see what is new!
The Datasets screen and widgets display information about datasets, provide access to data management functions, indicate the dataset roles, list the services using the dataset, and show the encryption status and the permissions the dataset has in place. The screen focuses on managing data storage including user and group quotas, snapshots, and other data protection measures.
Datasets Screen The Datasets screen displays No Datasets with a Create Pool button in the center of the screen until you add a pool and the first root dataset.
TrueNAS SCALE offers two Access Control List (ACL) types: POSIX (the SCALE default) and NFSv4. For a more in-depth explanation of ACLs and configurations in TrueNAS SCALE, 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.
TrueNAS CORE
TrueNAS Enterprise
TrueNAS SCALE
Compare Editions
TrueCommand
Software Status
FreeNAS
Compare Systems
F-Series
M-Series
X-Series
R-Series
Mini Series
Download TrueNAS CORE
Download TrueNAS SCALE
Get TrueNAS Enterprise
Where to Buy