Configuring the Apps Service

The first time you open the Applications screen, it displays an Apps Service Not Configured status on the screen header.

Apps Service Not Configured
Figure 1: Apps Service Not Configured

Click Settings > Choose Pool to choose a storage pool for Apps.

Choosing a Pool for Apps
Figure 2: Choosing a 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.

General System Settings
Figure 3: General System Settings

After an Apps storage pool is configured, the status changes to Apps Service Running.

Using the Installed Applications Screen

The Installed Applications screen displays No Applications Installed before you install the first application.

Installed Applications Screen No Apps
Figure 4: Installed Applications Screen No Apps

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.

Installed Applications Screen with Apps
Figure 5: Installed Applications Screen with Apps

Upgrading Apps

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.

Update Application Window
Figure 6: Update Application Window

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.

Deleting Apps

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.

Delete Application Dialog
Figure 7: Delete Application Dialog

Click Confirm then Continue to delete the application.

Using the Discover Applications Screen

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.

Applications Discover Screen
Figure 8: Applications Discover Screen

Browse the widgets or use the search field to find an available applications. Click an application widget to go to the application information screen.

Application Information Screen Example
Figure 9: Application Information Screen Example

Click Install to open the installation wizard for the application.

Installing Official Applications

Official applications found on the Chart catalog train are pre-configured and only require a name during deployment.

Application Install Screen Example
Figure 10: Application Install Screen Example

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.

Installed Application Example
Figure 11: Installed Application Example

Changing Official Application Networking

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.

Advanced/Kubernetes Settings
Figure 12: Advanced/Kubernetes Settings

We recommend using the default Kubernetes Node IP ( to ensure apps function correctly.

Container Image Management

Click Settings > Manage Container Images to see every container image downloaded to TrueNAS.

Apps Manage Container Images
Figure 13: Apps Manage Container Images

Images can be updated and deleted from this screen, or click Pull Image to download a specific custom image to TrueNAS.

Pull a Container Image
Figure 14: Pull a Container Image

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.

Installing Custom Applications

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.

Changing Custom Application Networking

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 ( to ensure apps function correctly.

Section Contents

  • 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.