Installing TrueCommand Cloud
6 minute read.Last Modified 2023-11-17 16:05 EST
TrueCommand is versatile and offers several different install options. TrueCommand Cloud is the preferred method for using TrueCommand since it does not require local resources or have specific hardware requirements to get started!
Please note that a credit card number is required for Cloud Signups.
If you are 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. Inquire with 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.
If the email does not arrive within a few minutes, check the address spam folder. 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.
Future login attempts to the iXsystems account requires entering a one time password (OTP) sent to the registered email address. Three failed login attempts results in a temporary account lock for 30 hours.
Continued failed login attempts can result in a permament account block. If this occurs, contact iXsystems Support to request unblocking the account.
Customers who purchase iXsystems hardware or that want additional support must have a support contract to use iXsystems Support Services. The TrueNAS Community forums provides free support for users without an iXsystems Support contract.
|Contact Method||Contact Options|
|Telephone||Monday - Friday, 6:00AM to 6:00PM Pacific Standard Time:|
US-only toll-free: 1-855-473-7449 option 2
Local and international: 1-408-943-4100 option 2
|Telephone||After Hours (24x7 Gold Level Support only):|
US-only toll-free: 1-855-499-5131
International: 1-408-878-3140 (international calling
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 Provision Now 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.
Next, add a client and create a WireGuard config file.
From the account home page, click Manage.
To obtain a TrueCommand WireGuard config file, add a client.
Under Create Access Client enter a nickname, then click Add.
After adding the client, click to download the configuration file.
Open Wireguard on your system and click Add Tunnel.
Select the downloaded TrueCommand WireGuard configuration file.
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.
Next, 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.
After connecting all systems to TrueCommand Cloud, refer to the TrueCommand User and Administrator Guides for instructions on 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).
When accessing the interface for the first time, you must 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, then click SIGN UP.
TrueCommand creates the admin login credentials and displays the login page.
You can now log into the TrueCommand web interface with the new administrator account credentials.
TrueCommand users can reset their passwords from the login screen. Enter the username then click FORGOT PASSWORD.
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.
Enter the user name in the login screen and the reset password code, then click SIGN IN. The user can then go to their profile to change their password.