Users Screens

The Credentials > Users screen displays a list of user accounts added to the system. By default built-in users, except for root, are hidden until you make them visible.

The Show Built-in Users toggle shows or hides built-in users. Enable it to display the list of built-in users.

To hide built-in users, disable Show Built-in Users.

The Users screen shows the pre-defined administrator role assigned to the user.

Add opens the Add User screen.

Click on a user row to show the user details screen.

The expanded view of each user includes details for that user, including the home directory location, shell, Samba authentication, SSH key, and sudo command access (if assigned). It provides the option to edit or delete the user, and access user audit logs.

Edit opens the Edit User screen. Delete opens a delete confirmation dialog.

The Add User and Edit User configuration screens display the same setting options. Built-in users (except the root user) do not include the Home Directory Permissions settings, but all new users created, such as those for an SMB share like the smbguest user, do.

Identification settings specify the name, user name, password, and user email.

Identification Settings

Setting	Description
Full Name	Required. Enter a description for the user, such as a first and last name.
Username	Required. Enter a user name of up to 16 characters in length. When using NIS or other legacy software with limited user name lengths, keep names to eight characters or less for compatibility. Do not begin the user name with a hyphen (-), and do not include a space, tab, the comma (,), plus (+), ampersand (&), percent (%), carat (^), open or close parenthesis ( ), exclamation mark (!), at symbol (@), tilde (~), question mark (?), greater or less than symbols (<)(>), or equals (+) in the name. You can use the dollar sign ($) as the last character of the user name.
Disable Password	Use the toggle to disable the password for the selected user. At least one user with administrative privileges must have a password enabled.
Password	Required. Enter a user password unless you set Enable Password login to No. A password cannot contain a question mark (?). The Edit User screen displays New Password.
Confirm Password	Required. Re-enter the value entered in Password. The Edit User screen displays Confirm New Password.
Email	Enter the email address of the new user. This email address receives notifications, alerts, and messages based on the settings configured.

User ID and Group settings specify the user ID and groups this user belongs to.

Directory and Permissions settings specify the user home directory and the permissions for that home directory.

Authentication settings specify authentication methods, the public SSH key, user administration access, and enable/disable password authentication. The add and edit user screens grant access to a shell option, but the privilege screen Web Shell Access setting determines the ability to see the System > Shell screen.

To view API keys that are linked to different user accounts, visit Credentials > Users and click the API Keys button on the right side of the screen.

The API Keys selection takes users to the Users API Keys page, which provides a table of all API keys linked to user accounts on your TrueNAS.

• Click edit Edit to edit an API key
• Click delete Delete to delete an API key