Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
96 changes: 85 additions & 11 deletions content/TCGettingStarted/TCReleaseNotes.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,91 @@ aliases:
- /truecommand/3.1/tcgettingstarted/tcreleasenotes/
---

## TrueCommand 3.2.0

TrueCommand 3.2.0 enhances the functionality of prior releases with various bugfixes maintenance efforts. This update ensures that TrueCommand is compatible with TrueNAS 25.10.

## Obtaining the 3.2.0 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 ([sign up instructions]({{< ref "InstallTCCloud" >}})).

A self-hosted TrueCommand container is available from https://hub.docker.com/r/ixsystems/truecommand/tags under the tag **release-3.2.0** ([deployment instructions]({{< ref "InstallTCDocker" >}})).

## 3.2.0 Upgrade Notes

TrueCommand Cloud deployments are upgraded automatically by TrueNAS. Self-hosted instances must be updated manually by a local TrueCommand administrator.

As a best practice, back up your instance data directory before deploying 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]({{< ref "InstallTCDocker" >}}) for guidance.

This is a maintenance release that addresses SMART data parsing issues, resolves SMTP configuration problems with Fastmail, and removes iXsystems branding from the TrueCommand interface. The release also ensures TrueCommand is compatible with TrueNAS 25.10.

### TrueNAS Compatibility

TrueCommand 3.2.0 is tested and compatible with these TrueNAS versions:

* 13.0
* 22.12
* 23.10
* 24.04
* 24.10
* 25.04
* 25.10

### 3.2.0 Paths

Self-hosted Containers:
```mermaid
flowchart LR
A["Legacy (Pre 1.2)"] --> B
B["1.3"] --> C
C["2.2.2"] --> D
D["2.3.3"] --> E
E["3.0.2"] --> F
F["3.1.0"] --> G
G["3.2.0"]
```

## Release Schedule

{{< include file="/static/includes/ReleaseScheduleWarning.md" >}}

{{< releaselist name=tc-releases defaultTab=2 >}}

{{< expand "Software Lifecycle" "v" >}}
{{< include file="/static/includes/LifecycleTable.md" >}}
{{< include file="/static/includes/SoftwareStatusPage.md" >}}
{{< /expand >}}

## 3.2.0 Changelog

**September 9th, 2025**

The TrueNAS team is pleased to release TrueCommand 3.2.0!

Notable changes:

* Remove iXsystems branding from TrueCommand ([TC-3309](https://ixsystems.atlassian.net/browse/TC-3309))
* Smart data parsing error ([TC-3305](https://ixsystems.atlassian.net/browse/TC-3305))
* SMTP configuration with Fastmail not working ([TC-3304](https://ixsystems.atlassian.net/browse/TC-3304))
* Implement API version dropdown for FT+ RPC API ([TC-3310](https://ixsystems.atlassian.net/browse/TC-3310))

<a href="https://ixsystems.atlassian.net/issues/?filter=13163" target="_blank">Click here for the full changelog</a> of completed tickets that are included in the TrueCommand 3.2.0 release.

{{< include file="/static/includes/JiraFilterInstructions.md" >}}

### 3.2.0 Ongoing Issues

{{< enterprise >}}
We recommend that TrueNAS Enterprise High Availability (HA) systems be updated from the TrueNAS UI.

If TrueCommand 3.2.0 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.
{{< /enterprise >}}

<a href="https://ixsystems.atlassian.net/issues/?filter=13164" target="_blank">Click here to see the latest Jira tickets</a> about known issues in 3.2.0 that are being resolved in a future TrueCommand release.

## TrueCommand 3.1.0

TrueCommand 3.1.0 builds on the foundation of previous releases, delivering the latest feature enhancements, improved system stability, and expanded software compatibility. This major update introduces new monitoring tools, configuration options, and quality-of-life improvements to make managing your TrueNAS systems even simpler.
Expand Down Expand Up @@ -80,17 +165,6 @@ E["3.0.2"] --> F
F["3.1.0"]
```

## Release Schedule

{{< include file="/static/includes/ReleaseScheduleWarning.md" >}}

{{< releaselist name=tc-releases defaultTab=2 >}}

{{< expand "Software Lifecycle" "v" >}}
{{< include file="/static/includes/LifecycleTable.md" >}}
{{< include file="/static/includes/SoftwareStatusPage.md" >}}
{{< /expand >}}

## 3.1.0 Changelog

**March 25, 2025**
Expand Down
4 changes: 2 additions & 2 deletions data/properties/tc-releases.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -15,10 +15,10 @@ majorVersions:
- lifecycle: "Stable"
name: "TrueCommand 3.1"
releases:
- name: "3.1.0"
- name: "3.2.0"
type: "Stable"
link: "https://www.truenas.com/docs/truecommand/3.0/tcgettingstarted/tcreleasenotes/#310-changelog"
releaseDate: "2025-03-25"
releaseDate: "2025-09-09"
latest: true
- lifecycle: "Next"
name: "TrueCommand Next"
Expand Down
1 change: 1 addition & 0 deletions words-to-ignore.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1751,3 +1751,4 @@ udp
tmux
IOPs
Fangtooth
Fastmail