TrueNAS CORE
TrueNAS Enterprise
TrueNAS SCALE
TrueCommand
Compare Editions
Software Status
FreeNAS
Systems Overview
M-Series
X-Series
R-Series
Mini Series
Download TrueNAS CORE
Download TrueNAS SCALE
Get TrueNAS EnterpriseConnecting Your First TrueNAS System
4 minute read.
Last Modified 2022-11-14 08:09 -0500To add your first system to TrueCommand, click NEW SYSTEM on the dashboard.
Enter the system IP address or DNS host name, then enter a system nickname and password.
| Setting | Description |
|---|---|
| IP Address or Hostname | The system’s IP address or DNS host name. |
| Nickname | Required short-form identifier for this system. You cannot use system nicknames more than once. |
| Password / API Key | New password or API key. TrueCommand hides characters for security. |
| Password / API Key Confirm | Re-enter the password or API key. |
Click RESET FORM to clear the fields and reset the form if you make a mistake. Click ADD SYSTEM to add the new system. Click ADD AND CONTINUE to add this system and then continue to add more systems.
Log into your ixSystems cloud account and click Manage next to your TrueCommand subscription.
Under Service Details, copy the TrueCommand API Key.
Log into a TrueNAS system and click the TrueCommand icon in the upper right.
Paste the TrueCommand API key copied from the iXsystems Account Portal into the TrueNAS dialog window.
When the True Command logo starts moving, check the TrueCommand Cloud email address for a verification message. The email contains a link to the portal to confirm the connection and activate the TrueNAS system.
Click the Discovered Systems icon and select the TrueNAS system. TrueCommand automatically fills out the IP field using the WireGuard address. Fill in the TrueNAS system nickname and password information from the TrueNAS system, then click Add System.
The TrueNAS instance can take 10 to 15 minutes to fully sync up with TrueCommand Cloud.
When all systems are connected to TrueCommand Cloud, refer to the TrueCommand Administration articles for more instructions about setting up configuration backups, alerts, reports, and role-based access control.
To display the list of systems in TrueCommand, click the icon and select either System Inventory or Systems.
The Systems menu has two tabs: Systems and System Groups. These tabs contain all the options to connect and organize systems in TrueCommand. TrueCommand lists all added systems and their connection statuses in the Systems tab.
To connect a new system, click + NEW SYSTEM. Enter the system IP address or DNS host name, then enter a system nickname and password. Click RESET FORM to clear the fields and reset the form if you make a mistake.
Clicking the more details icon allows you to enter new connection details for a system in the list.
Misconfigured systems (such as one created with an incorrect password) appear offline on both the TrueCommand Dashboard and Systems list.
To enter new connection details for a system in the list, click the more details icon . Click RESET FORM to clear the fields and reset the form if you make a mistake. To remove a system from TrueCommand monitoring, click Delete.
TrueCommand administrators can organize systems into collections called groups. Grouping systems enables efficient system permissions and reporting management.
Open the System Groups tab to view the list of created groups and the systems they contain. Create a group by clicking Configure settings > Systems > + NEW GROUP. Enter a name for the new group and click ADD SYSTEM to add a system to the group. After you add all the desired systems to the group, click SAVE GROUP.
Editing a group allows you to update the group name or change which systems are members of that group.
To delete a system group, click Delete delete. Click Yes to confirm the deletion.