Leaderboard

Hey all! We've published a new blog post sharing some of the development work happening behind the scenes at HexOS. This time, we're highlighting our new end-to-end testing suite which is going to drastically help our development moving forward. Checkout the new blog post for more details! The docsite has also been updated to include two awesome user created guides regarding Immich. To be fully transparent, we are still figuring out what exactly the HexOS official solution looks like, but want to provide you with as much support as possible in the meantime. docs link: guide by @Forsaken (hub link) docs link: guide by @G-M0N3Y-2503 (hub link) Here is also a guide directly from the Immich community. If you have more specific questions/issues with Immich please put them in the Immich support section. You may have also seen that we are hiring! This role (along with our end-to-end testing) will be crucial for keeping up with apps and staying ahead of issues like the one we saw with Immich. Thank you to everyone who applied! We’ll be conducting interviews soon and are looking forward to chatting with you all.

Another mid-quarter update featuring: - Install Script v2 with interactive questions during app installation to support user preferences (eg. Plex claim code) - Fangtooth Support with full TrueNAS 25.04 compatibility and automatic pool upgrades - Enhanced User Management with better visibility and access to folder permissions Read the full release notes: https://docs.hexos.com/release-notes/command-deck/2025-11-06 NOTE: This update was applied automatically. You may need to clear your cache.

Looks like we have 25.10 in the wild (https://forums.truenas.com/t/truenas-25-10-0-is-now-available/57343), hope we can see a HexOS update based on this soon...

here are some low power server builds (not necessarily on hexos/truenas) https://docs.google.com/spreadsheets/d/1LHvT2fRp7I6Hf18LcSzsNnjp10VI-odvwZpQZKv_NCI/edit?gid=0#gid=0 These are just some general things to keep in mind you can can expect each hdd and ssd to add 2-7w at idle. not using a discrete gpu will save you 10-20w at idle keeping peripherals unplugged (monitor, keyboard, mouse) help a bit old amd cpus have trouble if c states are enabled. (c states are kinda sorta low power modes) fan power draw ads up skip the rgb

Might want to have https://hexos.com/blog/ redirect there also. Navigating directly still goes to the old blog.

Hey I just finished my hardware migration and I'm happy to report it was successful. These are the steps I did: Log into TrueNAS SCALE web interface Go to System > General Settings > Manage Configuration > Download File If you have encrypted datasets, go to Datasets > select your encrypted dataset > Export Key Shut down server and swap hardware Prepare HexOS installation drive and use it to boot Set up HexOS/TrueNAS SCALE, I left everything on default In your router settings, give the new hardware the same IP as your old one. Restart your TrueNAS server to grab the right IP. Go into TrueNAS SCALE web interface, log in Upgrade your version of TrueNAS. At the time of writing this post, the HexOS installation image is behind of what's was being supported/recommend by the HexOS web interface. Check the filename of the .tar that was created when you exported the configuration. It should have the version of TrueNAS that was used in it (i.e. 25.04.2.6). Select the same version from the upgrade screen and confirm that you want to switch upgrade train. Apply pending updates and the system will reboot. Go to Storage > Import Pool > find your zpool Got an error? Check step 9 again. Make sure you are using the same version of TrueNAS as your old boot drive. Go into System > General Settings > Manage Configuration > Upload File After reboot, go to Apps > Configuration > Unset Pool Restart TrueNAS Go back into the web interface, go to Apps > Configuration > Choose Pool Your apps should show back up and you should be able to start them. Go to the HexOS web interface. If you haven't already, unclaim your old server and claim the new one The hardware check screen should give you a warning about an existing pool. This is good, go onto the next screen and skip creating pool. Give your server a name and you should be good to go! Really hope that HexOS has an easily migration process in the future. I have learned so much about TrueNAS that it's making less sense for me to use HexOS.

Hey, No this has been fixed months ago, with the Q1 update I believe.

Just sharing some good news — my update went smoothly, and all apps, VMs, and backups are running normally under Fangtooth.

Unfortunately there are 2 version numbers for the apps in the truenas app catalog. The "version" which is what you see in hexos, this is just the iteration of the truenas docker app which has nothing to do with the overall application which is also called "app version" you can see both of these numbers in the truenas interface if you would like but here is a screen shot My "version" is 1.10.12 but that is the same thing as "app version" 2.2.3 so we are not actually behind. i totally get the confusion though and ill be sure to bring it up with the team. Just to clarify a few things Truecharts is a third party app store that afaik shut down and was never compatible with hexos All the apps you see come from the Truenas apps market which i believe is first party to truenas HexOS unfortunately does not have any control over app versions (as much as i wish we did for troubleshooting), this is all truenas

Yup it was added last night! Check the original post for instructions.

Thanks for reporting these issues. We are taking this feedback to heart and will work to address.

In addition to what M said, low idle power draw doesn't necessarily mean, low performance hardware, modern high performance HW also has amazing power savings potential & idle power draw, so you don't need to go low performance, or old HW. Some easy wins are disabling unused HW/parts in the BIOS (Audio, onboard NIC if a dedicated NIC is used, Wifi etc...)

Thank you to you and everyone that put together these tutorials. I was excited to give this a try, but even with the tutorials, this seems to be a less than straightforward process. On the first guide linked, I immediately encountered discrepancies between how my Truenas was configured/behaved and how the guide assumed your Truenas would function. First, the dataset I created did not seem to have the same "strip ACLs" button shown. My permissions section looked a little different as a result, but I feel comfortable tweaking the list manually to make it match the guide. The bigger issue for me was that I couldn't get my computer (MacOS via terminal) to SSH into the Truenas server. I kept getting a permissions denied error. I tried a small amount of googling, but I'm not sure I have the time or patience to try to attempt this. The second tutorial seems a little less beginner friendly. I thiiiink I could try to figure it out, but immediately after my first attempt of tweaking the permissions, I'm getting endless "operation not permitted" errors in the terminal. This is clearly user error on my end, but I wanted to post this for other HexOS users here - I definitely feel like I am the target audience of introductory homelabber that doesn't care to tinker with these things and I wanted to share my experience for other's visibility before they invest the time themselves. Unfortunately, I think it will be a better use of my time to wipe and start over on my immich backup. Hopefully they stay true to their word and this is the last time they make this sort of change, or I will probably look elsewhere for backing up my photos in the future. Thank you again to those that took the time to try to document guides on this process!

Down the Road, it would be really awesome if we would get a curated installation for Paperless-NGX! https://docs.paperless-ngx.com/ Paperless is a really awesome Document Management System for all sorts of things. Paperless have lots of Small Features like full OCR and full in document text search. With a Duplex scanner, you can easly backup ALL of your paper documents and have them automatically sorted - a perfect companion for HexOS that aims to make digital backups a breeze! With a Curated and easy install, it could also help to backup analog paper 🙂

We moved the blog to the docs site. I'll chat with @csmanel about getting RSS support for it.

I fixed it that night. We migrated all the previous blog posts to the doc site as well as updated the link to it from the home page.

since you are just replacing 2 drives, have you considered just plugging your 2 2tb drives and 2 8tb drives at the same time, copying over your data then removing your 2tb drives?

I hope that one day we'll see GPU virtualisation not relegated to datacenters, maybe if Intel makes a card worth splitting up. I've looked into the software side and there are too many competing ideas that all require a lot of maintainers by the looks of it so I'm doubtful of long-term support.

Hey, Buddy Backup isn't currently available and Hexos doesn't offer anything to do a backup to another machine. However if you login to Truenas go to Data Protection and there to the Replication Tasks. You can setup a new Replication task there following this guide: https://www.truenas.com/docs/scale/25.04/scaletutorials/dataprotection/replication/ But this requires that you can connect to the other server, via tunnel or domain name or sth. Similar.

Hey it would be cool to have a straight forward way to install Nextcloud (e.g. the all in one edition https://nextcloud.com/blog/how-to-install-the-nextcloud-all-in-one-on-linux/) on HexOS. I set it up myself on my homelab, but the setup was not as easy and while the software itself works great, I'm not as satisfied with my implementation. It offers a lot of features with a client that is available on a lot of devices already, essentially substituting Cloud storage, Google Calender, Contacts, Office products, Slack (e.g. for small businesses) and as I just saw even LLM like ChatGPT. This would add huge additional value to HexOS, since you easily could substitute a lot of subscriptions that way, while having enormous privacy benefits, a thing the target audience of HexOS would surely profit of. Especially if there is also a way to safely expose it to the internet.

Hey, It seams to be possible to use a GPU with multiple apps, but you need to login into truenas to do this: https://www.truenas.com/community/threads/can-multiple-apps-utilize-the-same-gpu.99757/#post-712876

Hello! Are there plans for HexOS to allow users to use (mirrored) SSDs for ZFS' tiered storage optimizations? The main three uses I'm thinking of: Enable high-endurance mirrored SSDs to accept synchronous writes (SLOG) Enable mirrored SSDs to store all file metadata (special vdev) Enable mirrored SSDs to store all small files (special vdev) While I'm sure popping into TrueNAS (for those with that experience) would work, I think implementing these directly in HexOS would be quite beneficial even for consumers with many small files and / or macOS devices. While not all performance-based vdevs are helpful in most scenarios, these would be great, especially the special vdev for small files, e.g., use the ultra-fast random access of SSDs for video editing project files or documents (special vdev) and especially the SLOG vdev for macOS SMB writes (always sync writes). Of course, in some far and away future, HexOS would identify when these vdevs would significantly improve performance, but manually turning them on & testing them out would also be neat through HexOS. I'm intentionally ignoring L2ARC, which requires much more careful hardware selection & tuning to get any benefit.

Thanks for confirming. I managed to successfully upgrade last night using the rsync method. Although I had to research how to do the SSH part, perhaps you could add this instruction for others? Otherwise the method comes across as very intimidating when in fact it was relatively straightforward.

i believe there is a skip setup button now. i would skip setup and then go into truenas to adopt your existing pool

hexos will not show the drives as used as support for special vdev in the hexos interface was never added. once a special vdev is added to a pool, their use is automatic. You don't have to worry about hexos seeing or not seeing it correctly.

Can the hexos team confirm if they are working on an automatic update solution for Immich, or are the guides provided the final solution?

Yeah....reading rainbow obviously did nothing for me. But i started the app and tried again, it wont upgrade. Now im getting the storage upgrade issue [EFAULT] Failed to execute 'remove_old_storage_migration' migration: Traceback (most recent call last): File "/mnt/.ix-apps/app_configs/immich/versions/1.10.8/migrations/remove_old_storage_migration", line 26, in <module> print(yaml.dump(migrate(yaml.safe_load(f.read())))) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/mnt/.ix-apps/app_configs/immich/versions/1.10.8/migrations/remove_old_storage_migration", line 10, in migrate raise Exception( Exception: Cannot remove old storage config while it is still in use. Please migrate to the new storage config first before upgrading. I see a button in TrueNAS app manager "Use old storage configuration" im going to download all my stuff, uncheck this option and then see if i can upgrade

apple silicon seems amazing and sometimes i can't shut up about how it would be amazing if i could run a home lab on apple silicon or apple comes out with a gaming handheld. looking forward to hearing what hardware you end up on. most important piece of advice is before you commit to your parts list, you should post it here and see if anyone has any recommendations. so many little things to keep in mind that are non factors when building say a gaming pc.

I’ve changed the default port numbers on my TrueNAS web server to free up ports 80 and 443 for other services. However, from the HexOS portal, it still tries to connect using the standard ports when interacting with TrueNAS. For example, if I try to edit an app’s configuration or launch the TrueNAS configuration from the portal, I don’t get the correct interface. It would be great if the portal could detect the configured port numbers via the API, or allow these to be set manually in the HexOS settings.

I haven't used Nextcloud or Opencloud but I imagine their file management solutions are similar to Google Drive. Paperless-NGX is like the "more advanced organization" option compared to Google Drive from my point of view. Paperless allows you to ingest documents through a variety of means (upload button, watched folder, reading emails and automatically saving attachments or the email based on rules). Then it tries to apply machine learning to extract the document date and other info like who the document is regarding, what kind of document it is, where it should be stored, all based on what you have manually added metadata for. If I have a receipts document type, it will learn what I consider a receipt and assign that automatically. It also OCRs all the documents and stores the text so it's searchable later. You can add custom metadata fields like a global document ID (I'm told). You can then search, view, organize, share these documents in the paperless web UI. You can customize how it stores all these documents on disk so you can still access them outside of Paperless if you want. There are a few apps that allow direct "scan to paperless" functionality with decent cropping. You don't scan documents so each page is a file. You ingest a PDF with multiple pages normally so you would scan with your phone or a scanner, then import to paperless. Though you can ingest images and other stuff.

Is there a way to cancel the task so it isn't stuck? Or so that I can try and re-install it? Edit: I had to manually install it from the TrueNAS UI, then uninstall it from HexOS to get it unstuck.

Kudos to the entire team for their hard work on this. Proper testing is a key component of our focus on delivering an excellent user experience and will continue to be integral to our mission. Great work to all involved!

I think if we are honest almost everyone would say they were disappointed in how this startup has gone including Eshtek. I don't think all of our disappointment is justified because it has nothing to actually do with HexOS. However, you have hit on two points that are hard to argue with. Why are we paying up to $200 to test this application? And TrueNAS what? As for the paying to test question, I guess I am starting to do the same (well kind of) as you because I have set it aside to wait for go live. Plex and Immich are the only current curated apps I would ever use and until the serious discussions on how to secure the NAS start my machine is just a giant backup drive. And as for the current absolute requirement to use TrueNAS to do ALMOST anything including troubleshooting curated app failures. Well, if I am going to have to hire TrueNAS support to properly setup all non curated and some curated apps, I'm probably better off buying beer for my current Unraid support buddy. Like many others, I saw the LTT video and thought "Holly crap, someone finally built a system I can manage myself. I got in at the Black Friday price so HexOS on a mostly recycles server is still cheaper that a Synology or Ugreen prebuilt server. Storage seems to be the biggest cost but I have to pay that either way. I'm sure I will keep checking in and looking at the officially curated apps to see if anything looks interesting but unless there is a solid security option, it's all pretty irrelevant to me. My problem is that if I had to pay $299 what would I need to pull the trigger? That may be a tough uphill struggle for Eshtek if they want to attract people who are not at least serviceable in TrueNAS. So instead of looking at an the app we have today and deciding what it must be going to look like in 1, 2 and 5 years, we can wait and see what 1.0 looks like. I doubt though it will ever just be point and click.

I am not a beta tester, i know i bought a beta test software. My issue is that after almost a whole year i can scan the forums and most issues someone will state, you will need to access truenas to fix it. If i need to access the free software to fix the paid software then I been duped and mislead after a year.. I can see that the team has curated a few more apps and that's great, but I gave yet to see the VM workspace. Will that be a 1.0 release or 2.0, 3.0 etc.? Yes, I understand this is beta but I need more meat than little morsels here and there. Honestly I'm just blabbing I don't run hex because the only reason I got hex OS is to not have to figure things out in truenas and creating simple shares for backup failed and i had to access truenas to fix permission. At that point i gave up and would rather use my electricity for something else. Don't get me wrong im waiting for the day that i can just point and click and be done.

hmm its not something i've looked into for a while let me check with someone else.

Could we get a forum section for install scripts? That way as a community we can post a thread for a specific app and people can share their scripts and ask for feedback? I think that'd be handy, but I don't think it needs to go in the normal Applications support forum because that might confuse people as it's definitely a more advanced thing at the moment! Thanks

i would say if you don't intend to do ai workloads, skip the gpu and get one of the few xeons with an igpu. just by existing a dgpu like your 1660 super will be using like 10-20w at idle. intel quick sync transcoding is actually really good and nothing to scoff at. I think even now it is considered the gold standard for low power transcoding

Title says it all. Thanks.

I would really like to see folding at home for HexOS

i'm not gonna go as far as saying never gonna happen but i'd say its on the furthest back burner if at all. special vdev is a scary one to implement because if it goes down, itll take the whole pool down with it on top of not being very useful for most homelab users slog also doesn't make the most sense for most users as to my best understanding it only really protects you in case of power loss and at that point you might be better served just getting a ups. Personally i do run a triple mirror special vdev on my storage pool and i think it causes some stability issues with hexos.

I would like to use HexOS as a sort of app-server (to manage my docker) and not as my primary storage. I already have multiple dedicated separate NAS boxes (Synology and Ubiquiti) that contain my family pictures, linux isos and other data I want my applications to use. Thus, I would like to mount various remote shares on hexOS so I can pass them along to Plex, Immich and other apps. I know (and I did in the past) that I can use the linux shell, create .smbcredentials and edit fstab to mount it, but it would be amazing to have a UI for it in HexOS. Is that something that is will happen in the future? As an explanation for why I don't simply run docker compose on ubuntu - truenas (and hexOS by extension) makes configuring redundant storage much easier - I can simply install truenas/hexOS and have mirrored boot drives and RaidZ1 pool for my appdata/cache/thumbs etc, while on a regular server I would have to do a bunch of shell stuff that I don't care to learn to be frank. To be clear: I am not asking about accessing hexOS-managed drives. I am asking about accessing remote drives from other machines on hexOS and passing them to various apps.

In case there is any confusion still on this topic, a local UI is coming...100%. We actually have already begun work (we have a docker container with the UI running at this point, but it's not fully functional yet).

@Dylan Thank you for your help! It really helped me get a better understanding of the bigger picture in regards to all this, and it helped me kinda jerryrig my own solution to it. Thing is, shortly after installing the OS I had also decided to update truenas scale, which I found out later that it isn't recommended to do so. It didn't break anything for me at least, so I just figured it's all good. But after having wrestled with the guides you sent me, and stumbling upon a random reddit thread, I ended up finding out that the issue causing this whole mess was that I had basically done a "default installation" of pretty much everything in Handbrake when doing it via truenas scale. So part of what the latest version of electric eel (truenas) did, was change how the apps are handled - and how they are placed, which is more relevant for this - which messed with how handbrake sets up storage paths to "watch" and output from how it's installed. The people in the reddit thread were talking about how it's essentially a "1-click solution" to change the already-existing apps to fit that update, but they didn't really talk much about when installing from scratch. Which is where that guide by Theo about radarr and sonarr really helped out, because it made me familiar with the finnicky nature of the storage options and premade datasets when installing something. So this is what solved it: (I had already deleted handbrake quite a while ago, so at this point it's without the app installed) I made a dataset for handbrake, in /mnt/HDDs/Applications/ with permissions set to user, group, and other, with root and read/write/execute (I figured why not, I didn't really feel like taking it one permission at a time and I'm fine with leaving it as it is now, but up to you (the reader) if you want to be more cautious about it). I did not make a config sub-dataset like the sonarr/radarr guide suggests for sonarr/radarr. I then installed handbrake with mostly the default options still as they are. However, I left the config storage to iXVolume because I figured it's not something I need to be messing with anywhere other than in the UI for the app and there it was already working fine previously - and then I changed all of the other storage options to Host paths with a folder I've set up myself. (I should've made more folders for it in order to separate the pre-encoded from the re-encoded video files, but I just wanted to get it over with to see how it goes.) So I gave it a shot, and it works fine now. Well, kind of. I still can't see the HDDs folder, although I could at one point during my trials and errors but then it wouldn't give me access so I decided to try something else. But now the built-in view of "storage" in the app's UI can see the video files just fine, in a place where I can place them; because Applications isn't accessible (nor viewable) to place files in, which is where I'm guessing Handbrake had assigned as its "storage" pathway before. Anyway, lesson learned without too much harm done, that I'm gonna have to mix things up a bit to work with the updated electric eel version of truenas scale, since HexOS is still meant to be used with the version it came with during its installation. Thank you for the help! It did push me in the right direction.

In the end HexOS turned into more of a TrueNAS installer for me. I don't know if that saved me a ton of time and hassle, or if it was more like an hour worth of following a guide instead, but either way getting up and running was very painless. After that, I can't think of a thing HexOS has actually fully supported without needing to pop into TrueNAS. Not even the health status in HexOS can be trusted, which is stil baffling to me. I've been saying I feel it was launched very prematurely, and I maintain that. I'm hoping that it was because they desperately needed cashflow, in which case HexOS could turn out well in the end. If, on the other hand, they felt it was in good shape to launch to early adopters, I would be much less optimistic. Time will tell. I've gotten the NAS to a state where it does the job now, without having done anything to break or confuse HexOS (at least that I can see), so I'm just using it now and seeing what the future brings. It might be HexOS, it might be shedding HexOS and just going pure TrueNAS. In a sense you could say I've shelved HexOS, because there's no reason for me to ever access its interface. If my boot drive exploded today I would probably just install TrueNAS and recover the pool there instead, because HexOS doesn't even offer a way to backup and restore itself (another baffling "nah, we don't need that before releasing" decision), or even recover an existing pool without at least threatening to wipe it in the process. But, technically, HexOS is still on my server, so there's that.

Could be me but I do this at a router / switch / vlan level. It also allows for monitoring and delegation a bit easier

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

If there's an iOS app, there needs to be an Android app too.

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.

Nextcloud would be great to have. I’m looking for an alternative to Google Workspace and it seems like Nextcloud might be a good option.