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

TrueCommand 2.1 Release Notes

  6 minute read.

Last Modified 2022-06-27 14:58 EDT

Software Lifecycle

TrueNAS Quality Lifecycle

Release StageCompleted QA CyclesTypical UseDescription
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

TrueCommand Schedule

All release dates listed are tentative and are subject to change. The items in this list might not show every deadline or testing cycle that iXsystems uses to manage internal effort.

The progress and specific work is being tracked through tickets opened in Jira. If you have a feature suggestion or bug report, create a Jira account and file a ticket in the TrueNAS or TrueCommand projects. TrueNAS SCALE tickets are also tracked in the TrueNAS Jira Project.

VersionCheckpointScheduled Date
2.2.0-RC.1Internal Testing Sprints30 May > 03 June 2022
2.2.0Code-freeze08 June 2022
2.2.0Internal Testing Sprints09 June 2022 > 01 July 2022
2.2.0Tag05 July 2022
2.2.0Release05 July 2022


March 29, 2022

The TrueCommand team is pleased to announce TrueCommand 2.1.1 is now available.

2.1.1 Changelog


  • [TC-1924] - Adjust log rotation to use max size
  • [TC-1968] - Add build/deploy github workflow to release/2.1

Bug Fixes

  • [TC-1913] - TrueCommand does not start when pointed to a custom certificate
  • [TC-1921] - Imported Certificates Are Not Showing In The WebUI
  • [TC-1934] - Mailserver Test Button Lacks Meaningful Output
  • [TC-1937] - Docker Does Not Start Again After Import Certificates
  • [TC-1941] - Unable to open TrueNAS proxy interface on cloud
  • [TC-1948] - Removal of team in edit-user page is not working
  • [TC-1966] - Removing Cluster Volume Hangs
  • [TC-1967] - Deleting Certificate Authorities not working
  • [TC-1982] - Cluster Volume not showing in UI
  • [TC-1983] - Middleware API crash when I try verify email of my profile in truecommand docker version
  • [TC-1985] - Handle instance where filewatcher util can fail on initialization
  • [TC-1988] - Do not fail deployment if Influx already setup
  • [TC-1990] - Trouble With Deleting Alerts


January 4, 2022

The TrueCommand team is pleased to announce TrueCommand 2.1 is now available.

TrueCommand 2.1 is the single pane of glass for:

  • TrueNAS CORE: Manage systems on standard servers, Minis, or even AWS.
  • TrueNAS Enterprise: Manage X-Series and M-Series systems with High Availability.
  • TrueNAS SCALE: Manage a group of systems running a TrueNAS SCALE cluster.

2.1 Changelog

New Feature

  • [TC-1184] - Add two-factor authentication support
  • [TC-1581] - Have TC auto-generate and use an auth token after initial NAS connect
  • [TC-1711] - NAS user management
  • [TC-1757] - Add SAML SSO support
  • [TC-1774] - Add ability to manage NAS users/groups for shares.
  • [TC-1823] - Add ability to reset user passwords from login page


  • [TC-1468] - EULA needs to identify GPL components
  • [TC-1489] - Question about the Dashboard System Options Menu
  • [TC-1603] - Update selenium tests
  • [TC-1655] - Include Group or All option for system selection for reports
  • [TC-1663] - Add email verification to user email
  • [TC-1772] - Multiple time formats in use
  • [TC-1789] - Alerts for failed/suspicious login activity on a NAS
  • [TC-1806] - Remove PostgreSQL and migration routine.
  • [TC-1811] - Add Test button for LDAP settings
  • [TC-1813] - Rewrite shell scripts to go binaries
  • [TC-1816] - Unique name for the TC instance when it registers a token on the NAS
  • [TC-1820] - Unix permissions widget
  • [TC-1821] - Remove ng2-validation dependency
  • [TC-1834] - Add verbose logging and log level config
  • [TC-1835] - Update SMR disk model scanning
  • [TC-1844] - Prune dead code
  • [TC-1850] - Add warning to Cluster feature
  • [TC-1857] - Delete Dataset shouldn't be an option for datasets with children
  • [TC-1865] - Bugclerk for TrueCommand team
  • [TC-1869] - Add a Confirmation screen when the cluster is successfully deleted
  • [TC-1876] - Disable adding/replacing/removing peers/bricks
  • [TC-1878] - Add Experimental flags to Users/Groups+SAML
  • [TC-1884] - Safety belt for Clustering feature
  • [TC-1893] - Add memory health check


  • [TC-1800] - Enhanced Authentication Support
  • [TC-1815] - SMB User Management

Bug Fixes

  • [TC-1761] - Used space on system tiles reported as a whole number
  • [TC-1768] - Storage Navigator and Datasets card issues
  • [TC-1783] - SMR Alerts: Disk/Model desync from NAS?
  • [TC-1784] - Share Count Numbers always 0
  • [TC-1812] - DNS lookup failure
  • [TC-1826] - Alert rules not staying paused
  • [TC-1829] - Network speed reporting issues
  • [TC-1833] - Clumsy resolving long alert messages
  • [TC-1839] - NAS API Error - Can't view Storage
  • [TC-1851] - Include the User's name and UID in the logs
  • [TC-1856] - Cluster creation - API error
  • [TC-1908] - Not deleting or reusing TSP
  • [TC-1911] - Mismatch between ignore_alerts in MW and UI

To Download this Release

Login to the TrueCommand Account Portal for downloads, documentation links, and licensing options. For storage clusters with more than 50 disks, the account portal also offers a free 60-day trial license with unlimited disks.

Minimum Supported TrueNAS Versions

Due to the changes in integrating with the TrueNAS middleware, the minimum version for full-support of functionality has changed with TrueCommand 2.1:

  • FreeNAS/TrueNAS 11.3 series - No longer supported. Does not provide realtime statistics or storage information, but you can still connect to them and use TrueCommand to initiate updates.
  • TrueNAS 12 CORE/Enterprise - Supported after 12.0-U3. 12.0-U2.1 and older are missing some key metrics in the realtime stats (disk/network usage metrics in particular), but work otherwise.
  • TrueNAS SCALE 21.03+ - Fully Supported (SCALE-20.12+ is supported excluding cluster functionality)

To Update to this Release

Prior To Updating

As a best practice, TrueCommand admins should backup their instance’s data directory before deploying TrueCommand updates. If issues arise after updating, admins can simply pull the previous TC docker image and redeploy with their previous data directory.

Important Note for Upgrading from v1.3

Updating from TrueCommand v1.3 to v2.0 or higher 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. Please use caution when upgrading production TrueCommand systems. If necessary, run TrueCommand 1.3 and TrueCommand 2.1 in parallel for a transition period. Simply use the “ixsystems/truecommand:1.3.2” docker image to continue using that specific version of TrueCommand.

Docker: Re-run docker pull ixsystems/truecommand to fetch the latest version of TrueCommand, and then restart your docker instance.

VM Image: Either reboot the VM or run systemctl restart truecommand.service. This will automatically fetch and start the latest Docker image of TrueCommand within your VM.

Known Issues

Seen InKeySummaryWorkaroundResolved In