Edit page
TrueNAS SCALETrueCommand Documentation Archive
This content follows TrueCommand 2.3 releases. Archival documentation is provided for reference only and not actively maintained.
Use the Product and Version selectors above to view content specific to different TrueNAS software or major versions.

Connecting Your First TrueNAS System

Connect Your First TrueNAS System Using the TrueCommand UI

To add your first system to TrueCommand, click NEW SYSTEM on the dashboard.

TrueCommand231DashboardNoListings

Enter the system IP address or DNS host name, then enter a system nickname and password.

TrueCommand231AddNewSystem

SettingDescription
IP Address or HostnameThe system’s IP address or DNS host name.
NicknameRequired short-form identifier for this system. You cannot use system nicknames more than once.
Password / API KeyNew password or API key. TrueCommand hides characters for security.
Password / API Key ConfirmRe-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.

Connect Your First TrueNAS System Using TrueCommand Cloud

Log into your iXsystems cloud account and click Manage next to your TrueCommand subscription.

Under Service Details, copy the TrueCommand API Key.

CloudSubscriptionServiceDetailsWireGuardClient

Log into a TrueNAS system and click the TrueCommand icon in the upper right.

SystemsAddFirstSystemTCButton

Paste the TrueCommand API key copied from the iXsystems Account Portal into the TrueNAS dialog window.

TrueCommandCloudConnectAPIKey

Approving the Connection Request

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.

NewSystemCreds

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.

Managing Systems in TrueCommand UI

To display the list of systems in TrueCommand, click the settings 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 more_vert allows you to enter new connection details for a system in the list.

Systems List

Adjusting Systems using the TrueCommand UI

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 more_vert . 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.

Organizing Systems into Groups using the TrueCommand UI

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   > 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.

SystemsNewGroup

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 . Click Yes to confirm the deletion.

Related Content