TrueNAS SCALETrueNAS SCALE Version Documentation
This content follows the TrueNAS SCALE 23.10 (Cobia) releases. Use the Product and Version selectors above to view content specific to different TrueNAS software or major version.

Setting Up SMB Home Shares

  3 minute read.

Last Modified 2024-03-19 08:38 EDT

Setting Up SMB Home Shares

TrueNAS offers the Use as Home Share option for organizations or SMEs that want to use a single SMB share to provide a personal directory to every user account. Each user is given a personal home directory when connecting to the share. These home directories are not accessible by other users. Only one share can be used as the home share, but other non-home shares can be created.

Creating an SMB home share requires configuring the system storage and joining Active Directory.

Creating a Pool and Joining Active Directory

First, go to Storage and create a pool.

Next, set up the Active Directory that you want to share resources with over your network.

Setting Dataset Permissions

Go to Datasets and click on the root dataset in the pool you just created, then click Add Dataset.

Name the dataset and set Share Type to SMB. Click Save.

Click on the new dataset. Click Edit on the Permissions widget.

Click the Owner Group dropdown list and change the owning group to your Active Directory domain admins.

GroupDomainAdminsSCALE

Click Use an ACL Preset and choose NFS4_HOME. Then, click Continue.

StoragePoolsOptionsEditPermissionsACLPresetHomeSCALE

Creating the Share

Go to Shares > Windows (SMB) Shares and click Add.

Set the Path to the prepared dataset.

The Name automatically becomes identical to the dataset. Leave this as the default. If you change the name follow the naming conventions for:

Set the Purpose to No presets, then click Advanced Options and set Use as Home Share. Click Save.

Enable the SMB service in System Settings > Services to make the share is available on your network.

Adding Users

Go to Credentials > Local Users and click Add. Create a new user name and password. By default, the user Home Directory title comes from the user account name and is added as a new subdirectory of Home_Share_Dataset.

AddUserDirPermsAuthSettings

If existing users require access to the home share, go to Credentials > Local Users and edit an existing account.

Adjust the user home directory to the appropriate dataset and give it a name to create their own directory.

After adding the user accounts and configuring permissions, users can log in to the share and see a folder matching their user name.

As of SCALE 22.12 (Bluefin) and later, TrueNAS does not support SMB client operating systems that are labeled by their vendor as End of Life or End of Support. This means MS-DOS (including Windows 98) clients, among others, cannot connect to TrueNAS SCALE SMB servers.

The upstream Samba project that TrueNAS uses for SMB features notes in the 4.11 release that the SMB1 protocol is deprecated and warns portions of the protocol might be further removed in future releases. Administrators should work to phase out any clients using the SMB1 protocol from their environments.

Related Content