I'm still on 24.10 and want to upgrade: Do I need to go to 25.04 first, or can I jump to 25.10?

Hello,

I’m still on (the latest version of) Community Edition 24.10.

I ended up putting off upgrading to 25.04 long enough that 25.10 is in the release candidate stage. Oops.

I previously upgraded from 24.04 (my first version of TrueNAS) to 24.10 without a problem, but I’ve never considered trying a double-jump upgrade before. Is it safer to go to 25.04 first, or can I jump straight to 25.10 once it’s fully released?

The train selector in 24.10 lets me choose either of them.

this means you can do either. So yes, you can upgrade directly to the higher version. the upgrade/import mechanism does know about the previous steps if there any.

If everything is working, I would wait for the 25.10 release and then watch the forums for problems. If everything is quiet for a week or so then do the upgrade process.

Afaik, it was always recommended to update from one major version to the next

2 Likes

If you’re upgrading now? Definitely to 25.04; 25.10’s still in prerelease status.

Even after that, iX generally only recommends $RELEASE for early adopters until the eve of $RELEASE+1–they like to talk out of both sides of their mouth on this question, but that’s their “official” stance based on their “software status” page.

2 Likes

This is what I was wondering about. I wouldn’t upgrade to 25.10 until it was out of RC, as @dan noted, but I was curious if there was a history of recommendations by the devs to not double-jump major upgrades. I probably should have just paged @HoneyBadger to ask, but I try not to do that unless I get really confused.

@dan I wasn’t so much worried about when to upgrade, as whether is even officially recommended to leapfrog major updates. I’m going to hold off on 25.10 until at least 25.10.1.

I don’t know about now, but at least in the past, especially in the earlier days when there were bigger changes during one version to the other it was definitely not recommended to jump 2 or 3 major version, but do the updates one at a time.

1 Like

This seems to be the official line.

  • Upgrade to the latest monitor version on your train.
  • Upgrade to the next major version. You will only be able to upgrade to the latest version in that train as it is the only option.
  • upgrade to the next major version and so on until you get the the latest. Do not skip versions.

Also, your target version should be classed as conservative or mission critical if it is a production machine.

2 Likes

That is what’s documented in the Software Releases page and individual release notes, for example https://www.truenas.com/docs/scale/25.10/gettingstarted/scalereleasenotes/#upgrade-paths

Update to the latest maintenance release of the current major version before upgrading to the next major version. You can then upgrade directly from the latest maintenance release to the latest release of the next major version.

The recommended method for skipping one or more major versions (covered further down on those pages) is to back up your config, fresh install, and then import the config, but this increases the chances of surprises if you skipped a version with breaking changes for part of your setup.

1 Like

Survived the update to 25.04. Thanks, everybody. :slight_smile: