WARNING: June 1st is the Apps Migration Deadline for TrueNAS 24.04 and 23.10

There is a blog planned, but it doesn’t provide all the technical detail.

Documentation is always improving and new features get documented. If something is missing, please provide direct feedback in the docs.

If you can verify it all works, put it in a forum post and the AI bot will start to use it as an answer.

FYI… it doesn’t all quite work yet. There is a bug where we check for allowed port numbers and don’t permit ports that are re-used from other IP addresses.

https://ixsystems.atlassian.net/browse/NAS-135842

We’ll update everyone when we know how and when we can fix.

1 Like

We’re investigating this now. Once we have fix in hand, we’ll schedule when it pushes. Sorry about that!

1 Like

Kris, do you happen to know if this bug related to ports will allow mDNS to work on the per IP apps? I’m not familiar enough with mDNS to know if it only relies on ports or if there is other network magic involved. I’ve been hoping to get the home assistant app working.

It should not be related to ports… it works at IP level, not TCP

If it doesn’t work, it would be a separate bug :slight_smile:

Edit, I found your other post… yes, mDNS is a separate issue. We’ll need to review.

Fix has merged into the apps catalog that should address the validation errors when using the same port on different IPs:

Be sure to refresh your catalog before testing.

1 Like

So if I happened to miss the deadline, are there any manual steps I can follow to migrate my plex app to EE / Fangtooth? That’s the only one I particularly care about migrating.


Edit: Okay looked at the EE release notes and found this.

Due to breaking changes involved in enabling host IP port binding, June 1, 2025 is the deadline for automatic apps migration on upgrade. Any users still running TrueNAS Apps on 24.04 after June 1 must re-deploy those apps after upgrading to 24.10 or later.


2nd Edit: Because I had almost all of my apps set to host paths, the recreation of my apps was actually very easy! I just created the app and pointed to the folder that the configuration lived in. All my recreated apps work perfectly fine!

I’d suggest you start a thread in the general channel… and describe how your data is arranged. do you have a separate dataset that you can attach to?

Copy a link in here. You will have to change your name from “wizkid” for the next month :slight_smile:

After June 1st, Cobia and Dragonfish users with Kubernetes Apps will need to manually back up and restore their application data and configuration to a new Electric Eel installation. The manual update process is more complex and should be avoided.

Is this process documented anywhere?

I’ve just discovered this announcement – there’s no indication anywhere on my TrueNAS dashboard that an update is available, and you’d only notice on the /ui/system/update page if you noticed the “Train” field is in fact a drop down menu.

It will depend a lot on how your data is laid out and the App setup. Each App has to be recreated and then attached to the datasets.

I’d suggest you start a new thread in General and post the link here.

Great to hear! But this is good guidance.
There was no intention to make it difficult to update… but it was even easier before June 1.
You can resume the Wizkid moniker :slight_smile:

I also missed the deadline (and email with a big shouty subject would have been appreciated), but couldn’t find any topic with instructions.

I already migrated off TrueCharts apps and only using TrueNAS ones now.

My apps are set up with default ixVolumes for config storage, but the actual data (like photos, etc) are always kept on Host Path volumes.

Does this mean I’m going to have a bad time doing a lot of manual export / import with the ixVolumes? Are these PVCs?

Thanks!

You’ve set things up in a good way.

I’d suggest a separate thread in the forum with the list of Apps you need to migrate.

You will generally be reinstalling the App and then attacking the Host Path volumes. The question is are there any specific Apps that might need more?

Does anyone know of any troublesome Apps?

Would it be possible to get access to the migration tool such that we could automate at least some parts of the migration process?

It would save me a lot of time and possible errors if I all env vars and fs mounts would be auto-migrated and I would only have to deal with networking manually.

The migration tools were integrated into the App catalogs… which had to be changed to allow per-App IP addressing. That was the reason for the June 1st deadline.

Hello, if we missed the deadline for the migration of applications, is it really over for my applications? Will I have to reinstall everything manually, or is there a future update planned for people who didn’t have time to migrate?

A “deadline” is a deadline. Sorry if our communication did not get through.

Most users have reported Ok experiences in re-installing. I’d suggest starting a thread in General with your Apps for any advice.

1 Like

Next time you should add an alert a few months/weeks before in the web interface…

We could have done it in TrueCommand… but can’t add alerts to old software.

1 Like

I don’t quite understand why was there a deadline for this… It doesn’t make much sense to me. If an update was possible before it should still be possible at any time…

Also I was on 24.10.2.1, not any older version. Shouldn’t this be a problem only for those on older systems?
I’ve upgraded to 24.10.2.2, but the problem persists…

I’m very disappointed with TrueNAS regarding this!