Get a Quote     (408) 943-4100   TrueNAS Discord VendOp_Icon_15x15px Commercial Support
TrueNAS.com Software Systems Company Community Security iX Portal Download
TrueNAS CORE TrueNAS Enterprise TrueNAS SCALE Compare Editions TrueCommand Software Status FreeNAS
Compare Systems F-Series M-Series X-Series R-Series Mini Series
About iXsystems Our Clients Reviews Careers Awards iX Blog & News iX Website Contact Us
Community Forum Discord TrueNAS GitHub TrueNAS Merch Store
Application Analytics Backup and Archival Cloud Data Mobility File Sharing iX Storj Media Creation Video Surveillance Virtualization
Industry Automotive Education Gaming Government Healthcare MSP Manufacturing Research & AI Media & Entertainment
Download TrueNAS CORE Download TrueNAS SCALE Get TrueNAS Enterprise Compare TrueNAS Editions Where to Buy
  1. TrueCommand
  2. /
  3. Getting Started
  4. /
  5. TrueCommand 3.0 Release Notes
Edit page
TrueNAS SCALETrueCommand Version Documentation
This content follows TrueCommand 3.0 releases. Use the Product and Version selectors above to view content specific to TrueNAS software or major versions.

TrueCommand 3.0 Release Notes

  6 minute read.

Last Modified 2024-03-19 09:20 EDT

TrueCommand 3.0 brings the latest feature development, stability fixes, and software compatibility updates together in a major version that is more functional and performant than ever before. Here are the major changes in this release:

  • An all-new Fleet Dashboard provides at-a-glance information for every system connected to TrueCommand.

  • New multi-system ZFS replication quickly backs up storage snapshots across connected TrueNAS systems.

  • The experimental clustering feature is deprecated and scheduled for removal in a future TrueCommand version.

  • The experimental iSCSI management feature is permanently removed. iSCSI shares previously created by TrueCommand continue to live on the individual TrueNAS systems.

Obtaining the Release

TrueCommand is primarily offered as a Software as a Service (SaaS) solution from iXsystems, but can be self-hosted as a container deployment.

TrueCommand Cloud registrations are available from https://portal.ixsystems.com. A valid email address and credit card is required (signup instructions).

A self-hosted TrueCommand container is available from https://hub.docker.com/r/ixsystems/truecommand/tags under the tag release-3.0.1 (deployment instructions).

Upgrade Notes

TrueCommand Cloud deployments are upgraded by iXsystems on an ongoing basis. Please use caution when upgrading production TrueCommand systems.

Self-hosted containers must be updated by a local TrueCommand administrator. As a best practice, TrueCommand administrators need to back up their instance data directory before deploying TrueCommand updates. Self-hosted containers are typically updated by backing up the container volume and pulling the latest available container version. See the container update tutorial for guidance.

Updating from TrueCommand v1.3 to v2.0 or later involves a database migration process. This preserves all configuration data, but does not preserve old performance statistics. Additionally, it is not possible to roll back to TrueCommand v1.3 from v2.1 or later.

An issue is found with High Availability (HA) TrueNAS SCALE 23.10.0.1 systems connected to TrueCommand 3.0.0-BETA.1. Update SCALE HA systems to TrueNAS SCALE version 23.10.1 or later before connecting to TrueCommand 3.0.

After upgrading to TrueCommand 3.0, you might need to edit and re-apply connected TrueNAS system passwords to ensure connectivity.

TrueNAS Compatibility

TrueCommand 3.0 is tested and compatible with these TrueNAS versions:

  • CORE 13.0
  • SCALE 22.12
  • SCALE 23.10 - High Availability systems are not yet fully supported.

Paths

Self-hosted Containers:

flowchart LR
A["Legacy (Pre 1.2"] --> B
B["1.3"] --> C
C["2.3.3"] --> D
D["3.0.1"]

Release Schedule

The release names and dates provided here are tentative and can change at any time.

TrueCommand

Container | Cloud

Previous
Stable
Next

TrueCommand Next

Anticipated:

Next Major Version TBD
Software Lifecycle

TrueNAS Quality Lifecycle

TrueNAS releases follow a general adoption guideline for their lifetime. Starting with the NIGHTLY builds, each stage of a major release incorporates more testing cycles and bug fixes that represent a maturation of the release. With each version release stage, users are encouraged to install, upgrade, or otherwise begin using the major version, depending on the specific TrueNAS deployment and use case:

Release StageCompleted QA CyclesTypical UseDescription
NIGHTLY0DevelopersIncomplete
ALPHA1TestersNot much field testing
BETA2EnthusiastsMajor Feature Complete, but expect some bugs
RC4Home UsersSuitable for non-critical deployments
RELEASE6General UseSuitable for less complex deployments
U17Business UseSuitable for more complex deployments
U2+8Larger SystemsSuitable for higher uptime deployments

The Software Status page shows the latest recommendations for using the various TrueNAS software releases.

3.0.1 Changelog

March 12, 2024

iXsystems is pleased to release TrueCommand 3.0.1!

This is a maintenance release to address issues found in the 3.0.0 version.

Notable changes:

  • The Legacy Dashboard is now the default landing page (TC-3145).
  • Further scrub passwords from audit logs and NAS user page (TC-3134, TC-3151.
  • Alert level field in Administration settings does not update bugfix (TC-3140).
  • NAS database backup pruning now reads the correct file time (TC-3146).
  • NAS RRD metrics are now archived on deletion (TC-3147).

Click here for the full changelog of completed tickets that are included in the TrueCommand 3.0.1 release.

To switch between detail and list views for the changelog, press t. Open the changelog in Jira to see the Export menu to print or download the changelog in various file formats.

3.0.1 Ongoing Issues

TrueNAS Enterprise

We recommend that TrueNAS Enterprise High Availability (HA) systems be updated from the TrueNAS UI.

If TrueCommand 3.0.1 is used to upgrade HA systems, the standby controller might fail to activate the updated boot environment, resulting in a version mismatch error between the controllers. If you encounter this issue, manually activate the updated boot environment on the active controller and then failover to complete the upgrade.

  • The Explore > Snapshots tab can timeout when selected for datasets with high numbers of stored snapshots (TC-3078).

Click here to see the latest Jira tickets about known issues in 3.0.1 that are being resolved in a future TrueCommand release.

3.0.0 Changelog

Click to Expand

December 19, 2023

iXsystems is pleased to release TrueCommand 3.0.0!

Notable changes:

  • Fleet Dashboard improvements (TC-3076 and TC-3075).
  • Audit logs are updated to protect potentially sensitive user information by excluding certain fields (TC-3012).
  • The Administration page allows configuring when idle user account sessions are automatically timed out.
  • TrueCommand 3.0 has not passed validation for Clustering and that feature is expected to be highly unstable in this release. With the current unmaintained state of the upstream Gluster project, consider this functionality deprecated. The clustering feature is scheduled for removal in a future TrueCommand revision.

Click here for the full changelog of completed tickets that are included in the TrueCommand 3.0.0 release.

To switch between detail and list views for the changelog, press t. Open the changelog in Jira to see the Export menu to print or download the changelog in various file formats.

3.0.0 Ongoing Issues

Click here to see the latest Jira tickets about issues discovered in 3.0.0 that are being resolved in a future TrueCommand release.

3.0.0-BETA.1 Changelog

Click to Expand
Early releases are intended for testing and feedback purposes only. Do not use early release software for mission critical tasks.

November 9, 2023

iXsystems is pleased to release TrueCommand 3.0.0-BETA.1! This is the first public release of TrueCommand 3.0 for early testing and review of features included in this major version.

Notable changes:

  • Allow reusing IP address/hostname for TrueNAS connections (TC-2672).
  • Additional warnings on cluster feature (TC-2630)
  • Default ports updated: 443 on TrueCommand Cloud deployments and 80 on self-hosted containers (TC-2573)
  • Bug fixes for SAML user creation (TC-2532)
  • Polish update availability notices on system cards (TC-2511)

Click here for the full changelog of completed tickets that are included in the TrueCommand 3.0.0-BETA.1 release.

To switch between detail and list views for the changelog, press t. Open the changelog in Jira to see the Export menu to print or download the changelog in various file formats.

3.0.0-BETA.1 Ongoing Issues

Click here to see the latest Jira tickets about issues discovered in 3.0.0-BETA.1 that are being resolved in a future TrueCommand release.

Have more Questions?

For further discussion or assistance, see these resources:

Found content that needs an update?  You can suggest content changes directly! To request changes to this content, click the Feedback button located on the middle-right side of the page (might require disabling ad blocking plugins).