Setting Up SMB Home Shares

As of SCALE 22.12 (Bluefin), MS-DOS SMB1 clients cannot connect to TrueNAS SCALE Bluefin. TrueNAS SCALE SMB does not support End-of-Life (EoL) Windows clients, including MS-DOS.

The Samba project, which TrueNAS SCALE uses to provide SMB sharing features, has deprecated the SMB1 protocol for security concerns. The Samba 4.16 release notes announced that they deprecated and disabled the whole SMB1 protocol as of 4.11. If needed, for security purposes or code maintenance, Samba continues to remove older protocol commands and unused dialects or those that are replaced in more modern SMB1 versions.

TrueNAS now uses Samba 4.17. TrueNAS still has SMB1 protocol support but:

  • MS-DOS-based SMB clients cannot connect to TrueNAS SCALE Bluefin.
  • MS-DOS-based SMB clients are no longer able to connect to any TrueNAS servers.
  • SMB clients determined to be end-of-life (EOL) by their vendor are not supported.

Administrators should work to phase out any clients using the SMB1 protocol from their environments.

Client systems that can only use the SMB1 protocol for SMB shares are no longer capable of connecting to SMB shares created in TrueNAS SCALE 22.12 or later.

Refer to Samba release notes for more information.

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.


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


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.


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.