Leaderboard

Hi, very nice update, here are some points of feedback: On the Immich app, it showed the button "An updated configuration is available for this app", which I clicked. Afterwards, my Immich instance wouldn't start up again. I looked into it on the truenas interface where the server container wouldn't start but instead display long error messages before crashing. I noticed that the data storage path was moved from "Host Path" to ixVolume. After I changed it back to the original path, everything worked again. If the switch to an ixVolume is intended, I'd like to have the option (in HexOS) to choose a host path instead, as I want to be able to access my photos via the smb share from another pc. I guess, my trouble with the immich app could have been avoided, if the update notification in the HexOS interface showed the changes clearly, instead of the generic "This will reset every change you made in TrueNAS" message that pops up right now. Also, I installed Nextcloud before it was curated on HexOS, so now I would be interested in migrating my installation to the curated version (without uninstalling and re-installing the app). I tried using the configuration update button, which (expectedly) did not do anything.

HexOS Gets a Major Upgrade This release introduces an improved Apps experience, new apps, two-factor authentication support, improved GPU support, and Goldeye compatibility. Read more about it on our docsite here at Command Deck Update - December 26, 2025 Also check out our latest blog for even more details! NOTE: This update was applied automatically. You may need to clear your cache.

Let's Talk About Immich If you've been running Immich on HexOS this year, you know it hasn't been smooth sailing exactly. We want to talk about what's happened, why it was so challenging, and how we're working to handle these situations better in the future. What Happened? Earlier this year, Immich deprecated their old storage configuration and required all users to migrate to a new structure. For users running Immich through docker-compose or other manual setups, this meant updating some configuration files and running a few commands. Annoying, but manageable. For some HexOS users, the migration was more involved. Because of how TrueNAS SCALE structures application storage, moving to the new configuration required either reinstalling Immich fresh (the simplest solution) or manually migrating existing data between datasets (a process that involved SSH access, rsync commands, and careful attention to permissions). But if you're choosing between "reinstall the app" or "follow a 15-step guide," neither option feels great when you chose HexOS specifically to avoid that kind of complexity. Why Was This So Hard? When Immich made this change, we had a choice to make. We could have built a comprehensive rsync-based migration tool using the TrueNAS API. It has those capabilities. But that would have meant dropping everything else we were working on to build what amounts to using a cannon to kill a mosquito: a massive, complex solution for what we hope won't be a regularly recurring problem with this particular app. Instead, our community stepped up in a huge way. Users like @forsaken and @G-M0N3Y-2503 created detailed guides (to move or rsync your data). These guides walked through the manual migration process to preserve existing data in Immich. They focused on helping users through the immediate problem, while we continue building the platform we need to handle situations like this properly. That platform is HexOS Local: a locally-hosted management application that will let us perform complex operations without being bottlenecked by the engineering overhead of building one-off solutions through the SCALE API every time an application throws us a curveball. This reduces the technical burden on our team and, more importantly, gives us the flexibility to automate maintenance tasks that previously would have required manual intervention or massive engineering investments. This same platform will serve the Local UI/UX feature we've committed to delivering as part of our 1.0 release. We'll be talking a lot more about HexOS Local in an upcoming blog post, but the key takeaway is this: we're building HexOS to handle whatever the open-source ecosystem throws at it, without having to choose between "drop everything and build a custom tool" or "make users SSH into their servers." What About Right Now? If you're currently running Immich on the old storage configuration and haven't migrated yet, you have options: The simple path: Reinstall Immich fresh with the new configuration. Your photos will need to be re-uploaded, but the setup is clean and straightforward. The preservation path: Follow one of the community migration guides to keep your existing data in place. These guides are more technical and require command-line access, but they work. Our recommendation depends on your situation. If you have a manageable photo library and good backups, the fresh install is probably your best bet. If you have years of photos, carefully organized albums, and user configurations you don't want to recreate, the migration guides are there for you. And if this seems to daunting, email support@hexos.com so we can schedule a time to assist you directly. Moving Forward The Immich situation showed us exactly where we need to invest engineering effort. We can't keep facing the choice between building massive one-off solutions or asking users to break out the terminal. That's not sustainable, and it's not the HexOS we're building. Immich is an incredible project. It's exactly the kind of self-hosted solution we want to make accessible to everyone. The team behind it recently released v2.0, marking their stable release with better upgrade paths going forward. We're committed to making sure that when the next complex maintenance task comes up, whether it's Immich or any other application, we have the infrastructure in place to handle it gracefully. That's the HexOS we're building. Thanks for your patience while we get there.

Interesting thing just happened: I updated Prowlarr to test the restore functionality for Sonarr and it wasn't reset after the script got updated. Started up and had all the Indexers and connections still set up. Could someone from the HexOS Team maybe elaborate on what those updates in their scripts actually do?

Awesome! I have a Intel iGPU with Jellyfin. How do I know if transcoding is taking advantage of my iGPU now?

at the top of the hub, you can select the store tab and then orders or manage purchases. both should show you how many licenses you have

Same going to wait for a fix or reply on here if not truenas does have a rollback feature that let's you boot with the last version of truenas interface have used it before should work if it comes to it but does involve getting to the trunas interface via the IP of your server.

Hey, No, don't restart regularly, high memory usage is good, because unused memory = wasted memory! Hexos is using the memory for the ARC cache, this is a read only cache where Hexos is preloading files which it believes you are using next and can then deliver those files from the memory instead of having to read them from the drives. Depending on your current usage you will not notice any performance boost with more memory, but you might future proof it. Memory prices are currently going through the roof, only buy memory if it's not overpriced.

We are investigating these issues. Thank you for reporting. I can confirm that when a curation gets updated, it can enable things like GPU transcoding. Our apologies for any inconvenience this has caused and we will work to right this in a future update.

😎 All part of the Beta experience lol As long as I don't lose my ACTUAL data I'm cool. Ripping all those DVDs was a PITA.

I'm not sure if this is what you mean, but immich-go can be run by using the shell in truenas. At the risk of outing myself, an LLM of your choosing may or may not be helpful in suggesting some command syntax. (if you do that... please double check that your command makes sense using the immich-go documentation first, and you have an option of running the command in a 'test' mode where nothing is actually done just to verify your settings.) I'd also recommend using tmux to allow the script to run in the background if you have a transfer that is large, and for a very large transfer, I found it necessary to split it up into smaller chunks.

Oh wow! I could understand the mounts (if different than the default locations). The rest like API keys are a bit confusing unless you weren't able to reconnect to your previous database. It would be nice if the interface perhaps showed a comparison between what the existing configuration is and what the updated one looks like so that changes could be minimised before updating. That way, if I have to move a mount manually before the upgrade I would do that so that once the update is done everything works exactly as before I switch to the curated version.

Hey, yes this is a good idea, I currently have a similar setup, Hexos as main Server, Unraid as on site backup and a synology NAS as an off-site backup, planing to replace Unraid with Hexos once the HDD prices are normalising again. Let's first start with backups: Since Buddy Backup currently isn't available, you will need to setup the task replication in the truenas GUI to backup to your other Hexos. Since this is not in your local network you need to setup a VPN connection or URL or similar to be able to connect both server together. For the backup to your Unraid, you can use rsync to backup to it. Having app failover is an entire different and way more complex topic. The above backup is only creating snapshot but it's no live backup meaning it cannot be used for app failover since the data is not live. Hexos/Truenas Scale doesn't have app failover support, this is exclusively reserved for the entireprise stuff. I know that some apps have some way to have this, but this depends on the app and requires additional setup per app etc. The easiest thing would likely be running everything in a VM in proxmox and have High Availability setup, but this comes with it's own set of restrictions. Unfortunately, there is no easy or moderate complex way to set up app failver

They did post on X.

Hello all! We are excited to announce HexOS Local, powering the new local UI/UX for HexOS and capable of so much more. Read more about it on the Blogpost - Introducing HexOS Local

Just here to say - you guys are awesome and thanks for keeping your promises! I'm perfectly fine with deck and enjoy being able to pull up the stats quickly anywhere I am, but local hosting is so important to this community, so thank you.

With Back Up Buddy, will I be able to backup applications and vm's so I can restore them anywhere? I'm very hesitant to start hosting applications until there's a way that I can ensure the app data is safely backed up and restoreable. The hope for this feature is essentially what brought me to HexOS.

Buddy backup will definitely work with two licenses under the same account. You will be your own buddy 😉

As of today, yes, you can access your server from anywhere using deck.hexos.com. I have a discussion planned with the team to allow you to disable remote access which would be as simple as us verifying the WAN IP of the client device being used to connect to the deck and making sure it matches the server's WAN IP. When HexOS Local arrives, you will be able to even further reduce your cloud dependency, but there are some features like installing apps/VMs, configuring buddy backups, and e-mail notifications that will require a connection to our deck. Thankfully that connection is outbound from your server, which doesn't require you to open any ports on your firewall and expose the system to the wider net. We also do have plans to implement oAuth and 2FA in the future to further enhance security and options.

Great to see the progress being made compared to the early launch last year, I'm exited to see where it goes with the new upcoming roadmap. While I'll personally will be waiting till a few more curated apps will be available (such as Kometa and Bazarr) it seems at least a good solid foundation will be standing with the 1.0 launch. Keep it up guys!

With LTT Official Folding Month VIII (Nov 1st - Dec 6th) coming up, It would be really nice to see a how to guide to get FoldingAtHome easily working from anyone who knows how. I just put a request out for help for anyone to provide a guide if possible. Here's hoping. https://hub.hexos.com/topic/3927-foldingathome-ltt-official-folding-month-viii-nov-1st-dec-6th-help-setup-hexos/

Sorry, if this has been asked before & posted elsewhere. Would be handy to have app support for steam caching, especially for big/medium family's/house hold share. I can understand this will not be on the radar as yet, while sorting other issues out/beta etc

I have tried several NAS Systems before, none of them had a official good functioning mobile app, where i could quickly check basic stuff on the fly. Stuff like Updating Apps, restarting containers / VMs, restarting the entire Server, only basic things like this would be awesome. With the Management being Cloud based right now, it should not even be that big of an issue i think.

An app would be awesome

My server has not come back up after the update is up on the local truenas interface but not hex os interface app are also up and running like pi hole etc