Skip to content

TrueNAS SCALE -> ClusterTool

With the upcoming “Electric Eel” version of TrueNAS SCALE, iX-Systems has decided to completely gut the kubernetes backend and screw over its community. However, we’ve got you covered so you can safely keep running your TrueCharts Charts.

Our new ClusterTool can, among other things, be used to craft yourself a new kubernetes backend to continue self-hosting using TrueCharts.

For this guide we’ll be using a TalosOS VM on TrueNAS SCALE, but any solid hypervisor would suffice.

Pre-Migrations Advisory

Prior to migration, we advise the following:

Ensure all “hostPath” storage is replaced with “NFS”-share based storage

With the future migration to Talos using ClusterTool, you won’t technically be able to reach these folders through “hostPath” anymore. Please ensure to make a seperate NFS share on TrueNAS SCALE for each of those folders and edit the TrueNAS SCALE App to point towards said share directly.

Please be sure to use the publicly reachable IP of the TrueNAS server and not 127.0.0.1.

To ensure a stable running environment, we would strongly advise you to ensure the TrueNAS SCALE host running NFS, uses a static IP and does NOT use a DHCP-supplied IP address, typically from your modem/router.

Ensure you setup the permissions on the Dataset according to this guide.

And configure the NFS Shares according to this guide.

Ensure all PVC storage has VolSync backups (not restore) Enabled

While we’ve not fully finished our design docs, there are big chances those are going to require you to already have VolSync backups of any PVC present.

Please follow the guides for setting-up VolSync backups on TrueNAS SCALE. However, setting recovery is not needed and currently not functional on our TrueNAS SCALE Apps. Hence this can be safely skipped.

Setup VolSync according to this guide.

Continue with ClusterTool Getting-Started

From this point onwards, please go through the complete ClusterTool Getting-Started guide.