Introduction to SCALE
IMPORTANT: Must Read!
All guides under this section are made for TrueNAS SCALE. We do NOT control anything made by iX-Systems, no matter how great or shitty it is.
More specifically we have no control AT ALL about the following:
- Adding/Creating certificates
- Backups
- Restore
- Rollback
- Opening the Shell
- All GUI elements except: Install-menu, Edit-menu and Portal-Button
Even if we made some tools and guides to make the above easier to use, we cannot provide any support for these features.
More specifically: Anything related to TrueTool has been deprecated and is now referred to HeavyScript, any guides still referring to TrueTool will be updated or replaced.
Installing Apps
Once you've added the TrueCharts Catalog to your SCALE installation, you can choose from 100s of apps to install through the catalog user interface.
- Your Apps pool must be configured before adding TrueCharts. When opening the Apps menu item on SCALE for the first time, you'll be prompted to choose a storage pool for your Apps.
- After creating your Apps pool, you'll be able to add the 3rd party TrueCharts catalog.
Requirements
- Your SCALE Apps has the TrueCharts catalog added and meets the minimum system requirements.
- You have a working Internet connection and can reach GitHub and truecharts.org from the host system.
- If you plan to add additional app storage to your app, review important information about app storage and host path validation.
Adding the App
To add a new TrueCharts app to your SCALE installation:
- Click Apps from the SCALE menu
- Go to Available Applications at the top of the Apps page
- Find the app you wish to install using the search bar (or by scrolling through the catalog) and click Install
- Configure your app for each section depending on your desired settings out the necessary information to configure your app for each section and click Next:
Application Name: Configure a custom name for your app and select a version to install.
General Settings: Choose the number of replicas, preferred timezone, and add custom environmental variables.
Networking & Services: Choose how you'd like to expose your app from the k3s network to your local network and the Internet. Storage and Persistence: Configure core app storage and add additional app storage.
Ingress: For TrueCharts apps you can configure Ingress with Traefik to easily proxy Internet traffic to your app.
Security & Permissions: Configure PUID, fsGroup, and other security and file permissions for your app. Other Options: You can also configure GPU support, addons (such as adding a CodeServer for easy file editing), and advanced app settings. - Once you've finished configuring your app, click Install to start the deployment process.
Give your app a few minutes to deploy. You can check its status in the SCALE task manager at the top right of your GUI.
Video Guide
Notes
- You can view specific configuration information about your app in its app-specific page by searching for it in the charts list, searching our guides, or by searching for threads about it on the TrueCharts Discord.
- If you see both a
incubator
andstable
version of an app in the TrueCharts catalog, you should always use thestable
version as it is the best maintained version. - Some apps are available in both the TrueCharts catalog and iXsystems default catalog. We recommend the TrueCharts version for access to features and capability alignment.
- Once an app is thoroughly tested and known to be stable, it can be moved from the
incubator
train to thestable
train. You can let the TrueCharts team know if a particular app appears to be working well enough to be moved to thestable
train.
Editing Apps
Editing Apps is possible since 21.08, although it has a slightly different GUI it exposes the same setting as installing an App.
Requirements
- Make sure your storage-pool is created and working
- Make sure you selected your storage-pool when you first opened the "Apps" interface, if not please refer to Configuring your Apps Pool
- Make sure you have a working internet connection and can reach github and truecharts.org from the host system.
- Make sure you already added the TrueCharts catalog from Adding TrueCharts to SCALE
- Make sure your App is installed and, preferably, working
Editing the App
- Go to
Installed Applications
- click the menu button on the right side of the App card
- Select
Edit
- Change any settings you want to change
- Submit your changes
The App will then go through a process of submitting your changes. If the process fails, your changes will not be submitted and the edit will be reverted. The process popup disappears, it might take a few minutes to actually deploy your new changes, due to some things that happen in the background.
Video Guide
Notes
- It's NOT advisable to switch between Nodeport and Loadbalancer, using the same ports. This WILL cause problems. If you edit an app and switch between NodePort and Loadbalancer, please be sure to use different ports.
Upgrading
Upgrading the App using the GUI
- Go to
Installed Applications
- Make sure your App reports that an Upgrade is available on the App Card.
- Make note of the current version, you might want to revert to this version in the future.
- click the menu button on the right side of the App card
- Select
Upgrade
- Confirm your wish to upgrade
The App will then go through a process of backing up(!) and upgrading. If the process fails, your changes will not be submitted and the edit will be reverted. After the process popup disappears, it might take a few minutes to actually deploy your newly upgraded App, due to some things that happen in the background.
Rollback
Reverting using the GUI
- Select the top 3 dots on your application card
- Select "Roll Back"
- Under "Version" - Click the dropdown and select which version you would like to rollback to
- Check the "Roll Back Snapshot" box
- Select "Roll Back"
Reverting using the CLI
- enter cli to enter the SCALE command line interface
- enter app chart_release rollback
It should give you this screen:
- Enter the release name and item_version like this:
(be sure to remove the # before the release name)
- Click save then click quit
It should show something like this, confirming the rollback:
Finding the last installed version
Sadly enough, SCALE does not lists which versions are available to roll-back to, but does required a version to be entered. There is a short walk-through to get the versioning history for the App in question:
- run
export KUBECONFIG=/etc/rancher/k3s/k3s.yaml
- run
helm history jackett -n ix-jackett
where "jackett" should be replaced with the name of the App that broke your UI. You'll see this:Take note of the "Chart" column, it lists the version numbers you can enter in the rollback interface, prefixed by the App Name. Of coarse only enter the version number in the GUI or CLI, not the name
Delete
Delete using the GUI
- Select the top 3 dots on your application card
- Select "Delete"
- Check the "Confirm" box
- Select "Continue"
Delete using the CLI
- Enter Truenas SCALE terminal via the GUI or SSH
- Type the following command
cli -c 'app chart_release delete release_name=NAME_OF_APPLICATION'
- ex:
cli -c 'app chart_release delete release_name=traefik'