Skip to content

Anthony Scaffidi

3 posts by Anthony Scaffidi

TrueNAS Scale TrueCharts Frequently Asked Questions

Hey everyone. We wanted to answer some of the frequently asked questions about TrueNAS Scale TrueCharts application support.

What happened to TrueCharts apps on TrueNAS Scale?

Unfortunately, IX Systems decided that with the upcoming Electric Eel TrueNAS Scale update (24.10) to switch the application backend to Docker and remove Kubernetes. TrueCharts is and always has been a Helm Charts project. Previous versions of TrueNAS Scale were able to install our Helm Charts due to its Kubernetes support. With the upcoming removal of Kubernetes from TrueNAS Scale, our Helm Charts can no longer be installed using the native app system. To clarify, app installations have been disabled entirely to prevent users from setting up an app environment that will soon be outdated, see “What happened to the TrueNAS Scale TrueCharts application catalog?” below.

Why don’t you just continue making TrueNAS Scale apps?

We never made “TrueNAS Scale Apps”; we have always made Helm Charts that TrueNAS Scale supported up to Electric Eel, thanks to the Kubernetes backend. Our charts ecosystem is not possible on a Docker-based OS. Additionally, as part of this IX Systems transition to Docker, they will no longer support third party app catalogues. Starting with 24.10/Electric Eel only the catalog from iX Systems will be available and options like custom app.

Why was there no warning about this change?

IX Systems announced their intention to move to Docker shortly after the release of Dragonfish (24.04) on 29 May 2024. As soon as the announcement was made the TrueCharts team started working on a solution for all of our TrueNAS Scale users.

Could you not have had a solution ready earlier?

TrueCharts is not affiliated with IX Systems. We found out about the removal of Kubernetes support on 29 May 2024 the same as everyone else.

So, does this mean that TrueCharts is dead?

No, TrueCharts is not dead. We have always made Helm Charts and our Charts can be installed on any Helm-compatible OS, not just TrueNAS Scale. We continue to provide these Helm Charts as always and they can already be installed on a compatible OS.

How do I install TrueCharts now?

You are able to install any compatible OS and add the TrueCharts repository.

I want to keep using TrueNAS Scale as my OS. What can I do?

We are currently developing ClusterTool. Once completed it will help create and configure a Kubernetes cluster on a Talos VM for use with TrueCharts. We already have created guides for setting up a Talos VM on TrueNAS Scale. Once ClusterTool is completed it will assist with the migration of your currently installed TrueCharts apps on TrueNAS Scale to a Talos VM. Please watch the News for more information as ClusterTool development continues ahead of the TrueNAS Scale 24.10 update.

Will ClusterTool migrate my application data to Talos?

No. Talos will only migrate the actual application/chart itself, not the data associated with it. Data for applications/charts that you would like to be migrated to Talos also, must be backed up to S3/B2 storage prior to migration using VolSync as described here.

Why Talos?

Talos is a lightweight OS specifically designed for running a Kubernetes cluster.

What about HexOS?

HexOS is an internet based WebUI for TrueNAS Scale. It utilizes API calls to TrueNAS Scale and as such has the same limitations as TrueNAS Scale.

What about insert your choice OS?

Our Helm Charts can be installed on any OS that supports installing Helm Charts. You are not required to use Talos. ClusterTool is a separate project that is being created to help create a Kubernetes cluster and migrate existing TrueNAS Scale users.

What happened to the TrueNAS Scale TrueCharts application catalog?

It was decided to remove the TrueNAS Scale TrueCharts application catalog to prevent any new user from starting use of TrueCharts on TrueNAS Scale during this transition period.

Why am I not seeing updates for apps?

Once IX Systems decided to announce the depreciation of Kubernetes on TrueNAS Scale we needed to divert our developer time from maintaining the TrueNAS Scale application catalog to work on ClusterTool.

Why couldn’t you keep the TrueNAS Scale TrueCharts application catalog running and up to date until ClusterTool is ready or Electric Eel is released?

TrueNAS Scale support for TrueCharts was always developer intensive. At any given point in time, Scale compatibility required more than a third of total dev time on the project to maintain. We are not able to do both maintain the catalog and work on ClusterTool. We decided to immediately focus on ClusterTool so that is ready for release before TrueNAS Scale 24.10.

My app has an updated and I want to install it.

Almost all apps will continue to run without updates.

I cannot wait I need to update my apps.

If you do not want to wait for ClusterTool you have the following options:

  1. Install a compatible OS and add the TrueCharts repository.
  2. Switch your applications to those provided by IX Systems. They have promised their applications will migrate to the new Docker system.

Cert-Manager Operator

After building our own MetalLB, CNPG and Prometheus operator charts, we’ve also now finished the work on building our own Cert-Manager operator chart. As of today this chart will be a requirement for new users if they want to use Cert-Manager and required for all users starting August 1, 2023.

If you have already installed clusterissuer follow the below guidance for installation of the Cert-Manager operator chart.

If you have not already done so add the operator train to TrueCharts as outlined here

  1. Run this in the system shell as root:
    k3s kubectl delete --grace-period 30 --v=4 -k https://github.com/truecharts/manifests/delete4
  2. Install cert-manager from the operators train.
  3. Update clusterissuer to the latest version of (2.0.1+).
  • If you are already on the latest version perform an empty edit of clusterissuer (Edit app and save without making any changes).

If you run into additional issues, please file a ticket with our dedicated support staff via the #support channel of our discord as normal.

Deprecating Old Operators

As part of limiting our promise not to introduce breaking changes to the charts within our Enterprise train, we’ve ensured both the new and old way of dealing with “operators” were both supported.

Starting August 1, 2023, we will completely drop support for the old (pre-July installs only, internal not user controlled) way of handling operators.

After August 1, 2023, additional checks for operators will be enabled, preventing users from making the mistake of installing charts without the right operator from the operator train present. This means that charts will prevent themselves from being updated when you’re still using the old operators at that time.

If you have already installed the metallb, prometheus-operator, and cloudnative-pg operators then no further action is required.

Prerequisites

Add the operator train to TrueCharts as outlined here

MetalLB

The MetalLB operator is only required for users of MetalLB, anyone who does not use or plan to use MetalLB can skip this section.

  1. Uninstall current metallb from Enterprise train.
  2. Run this in the system shell as root: k3s kubectl delete --grace-period 30 --v=4 -k https://github.com/truecharts/manifests/delete
  3. Complete MetalLB installation as outlined here

Prometheus

The Prometheus operator is required for the use of app metrics. Its installation is recommended.

  1. Run this in the system shell as root: k3s kubectl delete --grace-period 30 --v=4 -k https://github.com/truecharts/manifests/delete3
  2. Install prometheus-operator from the operators train.

CNPG

The cloudnative-pg operator is required for any applications that utilize postgres. Its installation is recommended.

  1. Follow the CNPG Operator Migration Guide to migrate to the new CNPG operator. Ensure you follow the guide carefully as data loss can occur with this migration if proper steps are not followed.

If you run into additional issues, please file a ticket with our dedicated support staff via the #support channel of our discord as normal.