TrueCommandTrueCommand Nightly Development Documentation
This content follows experimental early release software. Pre-release software is intended for testing purposes only.
Use the Product and Version selectors above to view content specific to a stable software release.

NAS Users and Groups

TrueCommand allows administrator users to create TrueNAS users and groups across multiple systems.

NAS Users and Groups

To add a NAS user or group to TrueNAS systems using TrueCommand, click the button found on system widgets on the main Dashboard, the systems listed on the Fleet Dashboard > Systems widget, and for administrator users, on the system rows listed on the Systems screen.

The Users option on the main settings dropdown menu only manages TrueCommand users and groups.

Adding TrueNAS Users

From the Users screen, click NEW USER to open the Create NAS User wizard.

NASUser1

Click Add System to select systems or system pools to grant this user access to. Users and groups created across multiple systems share IDs. Click Next to open the Users/Groups wizard screen.

NASUser2

Enter the user detail. You can also associate the user with existing groups or create new ones. To add a group, click + GROUP to open the Create NAS Group dialog.

NASUser2AddNASGroup

Enter the GID for the group and a name. Leave Smb selected to allow using the group for Samba permissions and authentication. Click OK, then click OK on the Confirm dialog. Click Next to open the Home wizard screen.

NASUser3

If you want the user to have a home directory, enter the path to the directory and set the default UNIX permissions. If the directory exists and matches the username, it is set as the user home directory. When the path does not end with a subdirectory matching the username, a new subdirectory is created. The home directory full path for the user shows on the Edit NAS User screen.

Select the Write permissions for Group and Other if granting more access than the default, then click NEXT to open the Authentication wizard screen.

NASUser4

Enter or paste the optional public SSH key of the user for any key-based authentication into the Sshpubkey field. Do not paste the private key. You can also allow users to authenticate with Samba, connect from a Windows machine with their Microsoft account, and use sudo commands.

Select Locked to prevent the user from logging in or using password-based services. Locking an account is only possible when Disable Password is not selected in SCALE (Bluefin or Cobia) and a password is created for the user account on the TrueNAS SCALE system. Click NEXT to open the Create confirmation wizard screen.

NASUser4

Review the settings then click CREATE to add the user. To make changes, click BACK until the wizard screen opens. Make your changes and click NEXT until the Create confirmation wizard screen displays, then click CREATE to add the TrueNAS user.

After creating the user, you can edit user settings in TrueCommand and the TrueNAS system UI.

Managing TrueNAS Users

To manage TrueNAS user accounts, while on the TrueNAS Users screen, click Edit on the user row to open the Edit NAS User for that user.

To delete a single user, click the in that user row.

To delete multiple users, select the users, then click REMOVE.

NASUserRemove

Adding a New Group

Click the button, then click Users and Groups. Select GROUPS as the filter option on top banner of the USERS screen. The TrueNAS group list displays. Click + GROUP to open the Create NAS Group screen.

NASGroup1

Enter a Gid and Name. Leave Smb selected to allow using this group for Samba permissions and authentication.

Click SAVE to create the group.

To add groups to another system, use the filter option on the top banner to select the system.

NASGroup3

Managing Groups

While on the TrueNAS GROUPS screen, you can edit or delete an existing NAS group.

NASGroupRemove

To edit a group, click the in the group row.

To delete a single group, click the in the group row.

To delete multiple groups, select the groups to delete, then click REMOVE.