Get a Quote   (408) 943-4100               TrueNAS Discord      VendOp_Icon_15x15px   Commercial Support Toggle between Light and Dark mode

Local Groups

  2 minute read.

Last Modified 2022-06-07 09:25 EDT

TrueNAS offers groups as an efficient way to manage permissions for many similar user accounts. See Users for managing users. The interface lets you manage UNIX-style groups. If the network uses a directory service, import the existing account information using the instructions in Active Directory.

View Existing Groups

To see saved groups, go to Credentials > Local Groups.


By default, TruNAS hides the system’s built-in groups. To see built-in groups, click then click Show.

Add a New Group

To create a group, go to Credentials > Local Groups and click Add.


GIDThe Group ID (GID) is a unique number TrueNAS uses to identify a Unix group. Enter a number above 1000 for a group with user accounts (you cannot change the GID later). If a system service uses a group, the group ID must match the service’s default port number.
NameGroup name cannot begin with a hyphen (-). Group name cannot contain a space, tab, or any of these characters: , : + & # % ^ ( ) ! @ ~ * ? < > =. You may only use $ as a username’s last character.
Permit SudoAllow group members to use sudo. TrueNAS prompts group members for their password when using sudo. Leave Permit Sudo disabled for better security.
Samba AuthenticationSet to let Samba permissions and authentication use group.
Allow Duplicate GIDsAllows more than one group to have the same group ID. We do not recommend enabling this.

Group Member Management

Register user accounts to a group to simplify permissions and access to large numbers of user accounts. To manage group membership, go to Credentials > Local Groups, expand the group entry, and click Members:


To add user accounts to the group, select them in All users and click . Select multiple users by holding CTRL while clicking each entry.