Get a Quote   (408) 943-4100               TrueNAS Discord      VendOp_Icon_15x15px   Commercial Support Toggle between Light and Dark mode
Edit this page

Connecting Your First TrueNAS System

  3 minute read.

Last Modified 2022-03-18 17:16 EDT

Connecting Your First TrueNAS System

SystemsAddFirstSystem

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

SystemsAddFirstSystemForm

SettingDescription
IP Address or HostnameThe system’s IP address or DNS hostname.
NicknameRequired short-form identifier for this system. You cannot use system nicknames more than once.
Password / API KeyNew password or API key. TrueCommand hades characters for security.
Password / API Key ConfirmRe-enter the password or API key.

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

Click RESET FORM to clear the fields and reset the form if you make a mistake.

Systems List

Adjusting Systems

Misconfigured systems (such as one created with an incorrect password) appear offline on both the TrueCommand Dashboard and Systems list.

You can edit a system from the Systems list by clicking the edit icon and then enter new connection details. 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

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

Connecting Systems to a TrueCommand Cloud Instance

Get an API Key

Log into the ixSystems cloud account and click Manage. Under Service Details, copy the TrueCommand API Key.

SystemsAddFirstSystemCloudAccount

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

SystemsAddFirstSystemAPIKey

Copy the API Key under Service Details.

Connecting from the TrueNAS UI

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.

SystemsAddFirstSystemTCConnect

Approve 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 on the New System alert, fill in the information from the TrueNAS system, and click Add System.

ConnNewSystemCreds

It can take 10 to 15 minutes for the TrueNAS instance 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.

Manual Connections

To connect a system to TrueCommand, open the Configure menu and click 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 hostname, then enter a system nickname and password. Click RESET FORM to clear the fields and reset the form if you make a mistake.

Systems List