TrueNAS CORETrueNAS CORE Nightly Development Documentation
This content follows experimental early release software. Use the Product and Version selectors above to view content specific to a stable software release.

User and Group Quota Screens

TrueNAS allows setting data or object quotas for user accounts and groups cached on or connected to the system. Go to Storage > Pools, find the desired dataset, and click to open the Dataset Actions menu and see the User Quota and Group Quota options.

User Quotas Screen

Clicking User Quotas from the Dataset Actions menu shows the User Quotas screen.

UserQuotasScreenNoQuotas

SettingDescription
Filter User QuotasEnter a string to show saved quotas that match the string.
ColumnsDisplays options to customize the table view to add or remove information. Options are Select All, ID, Data Quota, DQ Used, DQ % Used, Object Quota, Objects Used, OQ % Used, and Reset to Defaults. After selecting Select All the option toggles to Unselect All.
ActionsShows additional options to manage or add entries to this screen.

Actions

SettingDescription
Toggle DisplayChanges the view between filter and list views. By default, only user accounts with a quota are shown (filter view). Switching to the list view shows all available users, even if the user has no quota assigned.
Set Quotas (Bulk)Opens the Set User Quotas screen to add quotas.

User Expanded View

Click the expand_more icon to display a detailed individual user quota view.

UserQuotasRootUserExpanded

Click the edit Edit button to display the Edit User window.

Edit User Configuration Window

The Edit User window allows modifying individual user data and object quota values.

EditUserQuotaWindow

SettingsDescription
UserDisplays the name of the selected user.
User Data Quota (Examples: 500KiB, 500M, 2 TB)Enter the amount of disk space the selected user can use. Entering 0 allows the user to use all disk space. You can enter human-readable values such as 50 GiB, 500M, 2 TB, etc.). If units are not specified, the value defaults to bytes.
User Object QuotaEnter the number of objects the selected user can own. Entering 0 allows unlimited objects.

Click Set Quota to save changes or Cancel to close the window without saving.

Set User Quotas Screen

Click Actions > Set Quotas (Bulk) to see the Set User Quotas screen.

SetUserQuotasScreen

Set Quotas Settings

SettingsDescription
User Data Quota (Examples: 500KiB, 500M, 2 TB)Enter the amount of disk space the selected user can use. Entering 0 allows the user to use all disk space. You can enter human-readable values such as 50 GiB, 500M, 2 TB, etc.). If units are not specified, the value defaults to bytes.
User Object QuotaEnter the number of objects the selected user can own. Entering 0 allows unlimited objects.

Apply Quotas to Selected Users Settings

SettingsDescription
Select Users Cached by this SystemSelect the users from the dropdown list of options.
Search for Connected UsersClick in the field to see the list of users on the system or type a user name and press Enter. A clickable list displays of found matches as you type. Click on the user to add the name. A warning dialog displays if there are not matches found.

Click Submit to set the quotas or Cancel to exit without saving.

Group Quotas Screens

Clicking Group Quotas from the Dataset Actions menu shows the Edit Group Quotas screen.

EditGroupQuotasNoGroups

The Edit Group Quotas screen displays the names and quota data of any groups cached on or connected to the system.

SettingDescription
Filter Group QuotasEnter a string to show saved quotas that match the string.
ColumnsDisplays options to customize the table view to add or remove information. Options are Select All, ID, Data Quota, DQ Used, DQ % Used, Object Quota, Objects Used, OQ % Used, and Reset to Defaults. After selecting Select All the option toggles to Unselect All.
ActionsShows additional options to manage or add entries to this screen.

Actions

SettingDescription
Toggle DisplayChanges the view between filter and list views. By default, only group accounts with a quota are shown (filter view). Switching to the list view shows all available groups, even if the group has no quota assigned.
Set Quotas (Bulk)Opens the Set Group Quotas screen to add quotas.

Group Expanded View

Click the expand_more icon to display a detailed individual group quota view.

EditGroupQuotasExpandedView

Click the edit Edit button to display the Edit Group window.

Edit Group Configuration Window

The Edit Group window allows you to modify the group data quota and group object quota values for an individual group.

EditGroupQuotaWindow

SettingsDescription
GroupDisplays the name of the selected group(s).
Group Data Quota (Examples: 500KiB, 500M, 2 TB)Enter the amount of disk space the selected group can use. Entering 0 allows the group to use all disk space. You can enter human-readable values such as 50 GiB, 500M, 2 TB, etc.). If units are not specified, the value defaults to bytes.
Group Object QuotaEnter the number of objects the selected group can own or use. Entering 0 allows unlimited objects.

Click Set Quota to save changes or Cancel to close the window without saving.

Set Group Quotas Screen

Click **Actions > Set Quotas (Bulk) ** to see the Set Group Quotas screen.

SetGroupQuotasScreen

Set Quotas Settings

SettingsDescription
Group Data Quota (Examples: 500KiB, 500M, 2 TB)Enter the amount of disk space the selected group can use. Entering 0 allows the group to use all disk space. You can enter human-readable values such as 50 GiB, 500M, 2 TB, etc.). If units are not specified, the value defaults to bytes.
Group Object QuotaEnter the number of objects the selected group can own or use. Entering 0 allows unlimited objects.

Apply Quotas to Selected Groups Settings

SettingsDescription
Select Groups Cached by this SystemSelect the users from the dropdown list of options.
Search for Connected GroupsClick in the field to see the list of groups on the system or type a group name and press Enter. A clickable list displays of found matches as you type. Click on the group to add the name. A warning dialog displays if there are no matches found.

Click Submit to set the quotas or Cancel to exit without saving.