TrueCharts Setup

Last Edit: 2024.08.28

Overview

Setup the TrueCharts application catalog and install required applications on TrueNAS Scale.

Assumptions

WARNING: TrueCharts Depreciated

TrueCharts has unfortunately been depreciated with the pending removal of Kubernetes from TrueNAS Scale. Consider another solution, do not start a fresh deployment of TrueCharts applications. Refer to the following resources for more details.

Add TrueCharts

Navigate to the Applications page, Apps on the dashboard menu. By default there will be the official TrueNAS catalog already available on the system, and no installed apps.

Add Catalog

Select the Manage Catalogs tab below the heading.

Choose Add Catalog next to the heading. Review the warning posted by TrueNAS and be sure to vet catalogs you add.

Configure the Add Catalog wizard as follows to add TrueCharts.

SettingValueDescription
Catalog NametruechartsName of the catalog.
Force CreatefalseEnable to pull unhealthy trains.
Repositoryhttps://github.com/truecharts/catalogTrueCharts catalog git repository.
Preferred Trainsenterprise, stable, operatorsTrueCharts application trains to pull.
BranchmainBranch of the catalog repository to use.

Select Save and view the catalog in the list. The TrueCharts catalog will take a while to download the first time; there is no need to re-add it.

TrueNAS dashboard application catalog management page.

Browse Applications

Switch over to the Available Applications tab of the Applications page. You will see apps from TrueNAS and TrueCharts, with TrueNAS appearing first on the list. To limit the view to only TrueCharts applications by selecting Catalogs next to the heading and modifying the selection to TrueCharts only.

TrueNAS available applications from TrueCharts.

Install CloudNativePG

CloudNativePG (CNPG) is required by many TrueChart applications, install it from the operators train.

From the Available Applications tab, locate the TrueCharts application named cloudnative-pg and select Install.

The CloudNativePG app requires no configuration, select Save and view the application from the dashboard.

SettingValueDescription
Application Namecloudnative-pgName for the application.
Version#.#.#CloudNativePG version to use.

Install Prometheus Operator

The Prometheus Operator is also required by many TrueChart applications, install it from the operators train.

From the Available Applications tab, locate the TrueCharts application named prometheus-operator and select Install.

The Prometheus Operator application also requires no configuration, select Save and view the application from the dashboard.

SettingValueDescription
Application Nameprometheus-operatorName for the application.
Version#.#.#Prometheus Operator version to use.

References

1 2