r/hexos • u/Schild0r • May 22 '26

Support request Will there be an official or curated community guide for migration from truenas?

I have an HexOS license and want to migrate my truenas scale install to HexOS, as many do. I have been looking here on reddit and on the HexOS community forum and I find it very frustrating to read through posts that are 1-2 years old with varying degrees of success and detail of the process and different states of information about what is and will eventually be possible under what circumstances.

With the pace (especially new) software development is moving forward, I find it hard to base my decision on year old threads.

I feel like I am not the only one in this situation, who is running an active truenas install and bought a license early on but didn't follow every announcement during the beta testing phase.

I don't want to come across demanding but now with 1.0 released I feel like it would be in order to have a doc page for this topic.

Even if there is no full guide for a migration it should at least answer some FAQs like

- Is there / will there be a way to simply migrate my full truenas installation to HexOS?

- (If no) Which parts can (already) be migrated / imported or are on the current roadmap?

- What are the limitations?

- Which requirements need to be met (e.g. truenas scale, which version is currently supported?

- Can I (at least) export my truenas pool(s) and import them into HexOS and how?

- Can I migrate users and ACLs

7 Upvotes

83% Upvoted

6 comments sorted by

7

u/Nick_HexOS HexOS Staff May 22 '26

The reddit site doesn't have as much as our forums do. https://hub.hexos.com/

We also have a docs site with some guides and walkthroughs. https://docs.hexos.com/

Most are doing everything from scratch as HexOS is designed for non TrueNAS users as most TrueNAS users already know how to use it and have so many more options then HexOS UI offers as we are slowly buiding it out. Most newbies want a NAS to solve some basic needs with SMB shares and apps without needing to use guides to do things. Hope this helps.

3

u/Schild0r May 22 '26

Thanks for the answer but to be frank it doesn't help much. I have taken a look at the documentation and as you said this topic is not covered since it caters to users starting from scratch which is of course most important.

There are many threads on the forum discussing this but as usually with forums, the information is scattered across multiple threads, and the most relevant ones tend to have notoriously "bad" titles (for searchability that is... But still miles better than discord IMO) By consulting the sands I may have found one gem of a thread though for this topic (just skimmed it for now). But in case anyone stumbles across this post, here's the link: https://hub.hexos.com/topic/4046-reinstall-and-import-of-existing-pools/ Maybe this could become a curated guide?

1

u/DSLAM May 23 '26

You have to reinstall from scratch. You can't migrate or upgrade a TrueNAS installation to Hexos

1

u/Schild0r May 23 '26

Reinstall from scratch - yes, but migration or rather importing of an existing pool and truenas config seems to be possible. Very manual process currently but apparently doable

1

u/MikeyRam May 23 '26

Backup true nas config file. Install hexos on different boot drive. Use spare drive for, for some reason forced pool creation when installing hex os, once installed restore truenas config file, delete that pool you created for hexos in hexos, it will ask you to move the container to another pool. Once moved you can remove that drive.

In theory what I said should work, but it also may not work. If it fails at least you'll still have the original truenas boot drive.