TrueNAS Enterprise
TrueNAS SCALE
TrueNAS CORE
Compare Editions
TrueCommand
Software Status
FreeNAS
Compare Systems
F-Series
M-Series
H-Series
R-Series
Mini Series
Download TrueNAS SCALE
Download TrueNAS CORE
Get TrueNAS Enterprise
Contact an Enterprise SpecialistTrueCommand Version Documentation
This content follows TrueCommand 3.0 releases. Use the Product and Version selectors above to view content specific to TrueNAS software or major versions.
Systems
5 minute read.
The Systems screen is only available to administrator users.
To connect a system to TrueCommand, open the gear settings settings menu and click Systems. The Systems screen has two tabs: Systems and System Groups. The Systems and System Groups tabs contain all the options to connect and organize systems in TrueCommand. The Systems tab lists all added systems and their current connection statuses.
To connect a new system, click + NEW SYSTEM.
Enter the system IP address or DNS hostname, the nickname, and the password. If you make a mistake, you can reset the form by clicking RESET.
TrueCommand reconnects to systems after reboot or failover. In the event of invalid auth credentials after failover, reconnect after a few minutes by editing the system and re-authenticating. TrueCommand does not reconnect if it believes the credentials are invalid, which is the case if it tries to connect too soon to the controller undergoing failover before the Virtual IP has migrated to the other controller.
If the system has alerts or alarms, a blue circle with the number of current alerts displays to the right of the system name.
Each TrueNAS system listed on the Systems screen has an options menu that allows you to edit, delete or modify configuration settings for that system. Click the for the system to display the options menu.
Edit
Click edit Edit to open a panel on the right of the screen that displays the system setting fields you can edit. After making your changes, click SAVE CHANGES to update the system with the new values entered. Click RESET to clear the form and reset values to the previously saved settings for the NAS.
Users and Groups
Click Users and Groups to display the list of users or groups for the selected system.
Update
If the system has updates ready to apply, a green Update displays on the system information screen.
Click Update on the systems option menu to open the Update NAS window with information on the update.
Select Confirm, then click OK to update the system.
Click CANCEL to close the window without updating.
Services
Click Services to display the Services window with a list of services running or stopped for the selected system.
The options for services are adding it to start on boot-up, stopping, or starting/restarting. SelectSTART ON BOOT to add the selection to the services started at boot-up. Click the stop icon to stop a running service. Click the start/restart icon refresh to start a stopped service.
Config Backups
Click Config Backups to display the Config Backups window.
Click CREATE BACKUP to create a new system configuration backup.
Click (Download) next to a listed config to download that config locally.
Click next to a listed config to restore the system to that configuration.
Click next to a listed config to delete it.
If you want to delete config backups in bulk, click the checkbox next to each config you want to delete, then click DELETE SELECTED.
Delete
Click delete Delete to display a popup window and confirm you want to delete a selected system.
Deleting a system purges all collected data from the database.
TrueCommand administrators can organize systems into collections called groups. Grouping systems allows you to efficiently manage system permissions and reporting.
It is possible to configure multiple permissions for the same user account and system in different screens within TrueCommand.
When this happens, TrueCommand follows a specific flow to check permission settings for the account:
flowchart TB A(User settings for individual systems) --> B(User settings for system groups) --> C(Teams settings for individual systems) --> D(Teams settings for system groups)
When a user account has multiple permissions at the same level (user is a member of two teams that have different permissions to the same system), TrueCommand defaults to granting the user account the most permissive option between the conflicting permissions.
For example, user A is configured to have direct read and write access to system 1. This permission remains in place, even if user A joins a TrueCommand team that is configured with read only permission for system 1. If user A is configured to have read only access to system 1 and joins a TrueCommand team with read and write permission for system 1, the more permissive access is granted.
Open the System Groups tab to view the list of created groups and the systems they contain.
To create a group, click + NEW GROUP at the top of the Systems screen to open the New Group screen.. Enter a name for the new group, then click ADD SYSTEM to display a dropdown list of systems you can add to the group. After adding the system(s) to the group, click SAVE GROUP.
Each group has two management options:
Clicking the edit button edit opens a sidebar menu. You can make adjustments to the group in this manner. Add or remove systems from the group by using the Add System button or the remove delete button. Click Save Changes when finished with your changes to update the group to the new group settings.Edit
