Installing TrueCommand Cloud
5 minute read.Last Modified 2023-05-26 11:36 EDT
TrueCommand is versatile and offers several different install options. TrueCommand Cloud is the preferred method for using TrueCommand since it requires no local resources or specific hardware requirements to get started!
Please note that a credit card number is required for Cloud Signups.
If you’re purchasing TrueNAS Enterprise hardware or licenses, you might be eligible to receive an additional TrueCommand license that lasts the duration of the TrueNAS Enterprise contract. Contact iXsystems Customer Support for more details about adding TrueCommand to your TrueNAS Enterprise purchase.
TrueCommand Cloud is a SaaS offering of TrueCommand with a WireGuard VPN capability to connect TrueNAS systems through firewalls. TrueCommand Cloud is compatible with TrueNAS version 12.0 and newer.
Open https://portal.ixsystems.com and click Register.
Fill out the form using the email address you want to use.
Check the address spam folder if the email does not arrive within a few minutes. If the email is in the spam folder, mark it as not spam and add the account to the address book. After receiving the verification email, open the link provided to verify the account.
Log in to the verified account and click New Subscription.
Select the TrueCommand Cloud option and choose the subscription plan that best fits your current needs.
Click Continue to proceed.
Next, fill out the payment form.
Click Subscribe and wait until the form is accepted. The Account Services window confirms that you have an active TrueNAS Cloud account with an active subscription.
Click the Provision Now button located to the right of the Active Subscription listing.
Select a subnet that your network is not using from the Subnet dropdown list.
Click Create Instance. This returns you to the Account Services screen.
The next step is to add a client and create a WireGuard Config file.
From the account home page, click Manage.
To obtain a TrueCommand WireGuard config file you need to add a client.
Under Create Access Client provide a nickname and click the Add button.
After adding the client, click to download the configuration file.
Open Wireguard on your system and click Add Tunnel.
Select the TrueCommand WireGuard configuration file you downloaded.
Click Activate to initialize the Wireguard tunnel.
See the WireGuard home page for more information on WireGuard and WireGuard clients.
The TrueCommand Cloud IP address is on the iXsystems account portal.
When WireGuard is active, log in to the TrueCommand Cloud interface by clicking the TrueCommand IP address on the portal, or manually enter the TrueCommand Cloud IP in a browser.
The next step is to add systems to your configuration.
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.
For more information on connecting TrueNAS systems to TrueCommand Cloud, see Connecting Your First TrueNAS System.
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.
TrueCommand uses a self signed certificate for a secure connection. Because of this, many Internet browsers consider the IP address or DNS host name untrustworthy. In these cases, you must add the IP address or DNS host name as an exception to the browser to access the web interface. Adding an exception is shown here for two different browsers, but the procedure is similar for most browsers.
After the initial login, prevent this in future logins by adding your own certificate keypair and / or certificate authority (CA).
Click Advanced to view information about the error code. Click Proceed to hostname (unsafe).
Click Advanced to view information about the error code.
Click Add Exception. Set Permanently store this exception to permanently store the IP address or DNS host name in Firefox. Click Confirm Security Exception.
When accessing the interface for the first time, you need to create an admin account.
Enter a username and password. Read the Terms of Service, select I have read and agree to the terms of service, and click SIGN UP.
TrueCommand creates the admin login credentials and displays the login page.
You can now log in to the TrueCommand web interface with the new administrator account credentials.
TrueCommand users can reset their passwords from the login screen. After typing their username click the FORGOT PASSWORD button.
Enter the user email address (or where you want to send the reset login code).
An [AUTH] TrueCommand Password Reset email should arrive with the reset password login code. After receiving the code, enter the user name in the login screen and the reset password code and click SIGN IN. The user can then go to their profile to change their password.