5 minute read.Last Modified 2023-11-30 10:15 EST
The first time you open the Applications screen, it displays an Apps Service Not Configured status on the screen header.
Click Settings > Choose Pool to choose a storage pool for Apps.
We recommend keeping the application use case in mind when choosing a pool. Select a pool with enough space for all the applications you intend to use. For stability, we also recommend using SSD storage for the applications pool.
TrueNAS creates an ix-applications dataset on the chosen pool and uses it to store all container-related data. The dataset is for internal use only. Set up a new dataset before installing your applications if you want to store your application data in a location separate from other storage on your system. For example, create the datasets for the Nextcloud application, and, if installing Plex, create the dataset(s) for Plex data storage needs.
Special consideration should be given when TrueNAS is installed in a VM, as VMs are not configured to use HTTPS. Enabling HTTPS redirect can interfere with the accessibility of some apps. To determine if HTTPS redirect is active, go to System Settings > General > GUI > Settings and locate the Web Interface HTTP -> HTTPS Redirect checkbox. To disable HTTPS redirects, clear this option and click Save, then clear the browser cache before attempting to connect to the app again.
After an Apps storage pool is configured, the status changes to Apps Service Running.
The Installed Applications screen displays No Applications Installed before you install the first application.
Use Check Available Apps or Discover Apps to open the Discover applications screen to see widgets for applications available in SCALE.
After installing an application, the Installed screen populates the Applications area with a table of applications. Select an installed application to view and edit information and to access the Web Portal for the application, if applicable.
To upgrade an app to the latest version, click Update on the Application Info widget. To upgrade multiple apps, click the Update All button on the Installed applications header. Both buttons only display if TrueNAS SCALE detects an available update.
Update opens an upgrade window for the application that includes two selectable options, Images (to be updated) and Changelog. Click on the down arrow to see the options available for each.
Click Upgrade to begin the process and open a counter dialog that shows the upgrade progress. When complete, the update badge and buttons disappear and the application Update state on the Installed screen changes from Update Available to Up to date.
To delete an application, click Stop on the Installed Applications screen and wait for the status to show stopped. Click Delete on the Application Info widget for the selected application to open the Delete dialog.
Click Confirm then Continue to delete the application.
The Discover screen displays New & Updated Apps application widgets for the official TrueNAS Chart, Community, and Enterprise train applications based on the Trains settings selected on the Edit Catalog screen. First time SCALE installation includes the Chart catalog train. See Using SCALE Catalogs for more information.
Browse the widgets or use the search field to find an available applications. Click an application widget to go to the application information screen.
Click Install to open the installation wizard for the application.
Official applications found on the Chart catalog train are pre-configured and only require a name during deployment.
After installing an application, the Installed applications screen shows the application in the Deploying state. It changes to Running when the application is ready to use.
Official applications use the default system-level Kubernetes Node IP settings.
You can change the Kubernetes Node IP to assign an external interface to your apps, separate from the web UI interface, in Apps > Settings > Advanced Settings.
We recommend using the default Kubernetes Node IP (0.0.0.0) to ensure apps function correctly.
Click Settings > Manage Container Images to see every container image downloaded to TrueNAS.
Images can be updated and deleted from this screen, or click Pull Image to download a specific custom image to TrueNAS.
To download a specific image, click the button and enter a valid path and tag to the image. Use the format registry/repository/image to identify the specific image. The default latest tag downloads the most recent image version.
When downloading a private image, enter user account credentials that allow access to the private registry.
To deploy a custom application, go to Discover and click Custom App to open the Install Custom App screen. See Using Install Custom App for more information.
Custom applications use the system-level Kubernetes Node IP settings by default. You can assign an external interface to custom apps by setting one on the Networking section of the Install Custom App screen.
Unless you need to run an application separately from the Web UI, we recommend using the default Kubernetes Node IP (0.0.0.0) to ensure apps function correctly.
- Using SCALE Catalogs: Provides basic information on adding or managing application catalogs in TrueNAS SCALE.
- Using Install Custom App: Provides information on using Install Custom App to configure custom or third-party applications in TrueNAS SCALE.
- Community Apps: Notes about community applications and individual tutorials for applications.
- Enterprise Applications: Tutorials for using TrueNAS SCALE applications in an Enterprise-licensed deployment.
- Advanced (Kubernetes) Settings: Tutorials for using the advanced applications settings that are derived from the Kubernetes implementation in TrueNAS SCALE. Includes notes on configuring host path safety checks.