Apps

There are two main application screens, Installed and Discover. The Installed applications screen shows the status of installed apps, provides access to pod shell and logs screens and a web portal for the app (if available), and the ability to edit deployed app settings.

The Discover screen shows widgets for the installed catalog of apps. The individual app widgets open app information screens with details about that application, and access to an installation wizard for the app. It also includes options to install third-party applications in Docker containers that allow users to deploy apps not included in the catalog.

The first time you go to Apps, the Installed applications screen header shows an Apps Service Not Configured status and dialog opens prompting you to choose the pool for apps to use. You must choose the pool apps use before you can install applications. See Choose A Pool for Apps for more information.

After setting the pool, Apps Service Running shows on the screen header.

The Installed applications screen displays Check Available Apps before you install the first application.

Check Available Apps or Discover Apps opens the Discover screen.

Configuration on the Installed applications header displays global settings that apply to all applications.

• Choose Pool opens the Choose a pool for Apps dialog.
• Unset Pool shows after setting a pool for applications to use. It opens the Unset Pool dialog.
• Manage Container Images opens the Manage Container Images screen.
• Sign-in to a Docker registry opens the Docker Registries screen.
• Settings opens the Settings screen with four train options. Use to add or remove other trains to the one catalog of applications.

Choose Pool opens the Choose a pool for apps dialog. The Pool dropdown list shows a list of available pools on the system. Choose sets the selected pool for use by applications.

The first time you open the Installed applications screen a dialog prompts you to choose the pool for apps to use for storage. Select the pool from the dropdown list, then click Save. This starts the applications service. If you exit out of this dialog, to set the pool, click Settings > Choose Pool to select a storage pool for apps.

If a pool is not selected and you attempt to install an application, a dialog window prompts you to select a pool before the installation wizard shows.

If you select a new pool in the Pool dropdown after previously configuring the apps service, the dialog displays the Migrate existing applications option.

Migrate existing applications migrates all installed applications to the new applications pool.

Migrate existing applications only affects data saved in the apps dataset, such as the installed app loacation and iXvolume storage. Data in mounted host paths is migrated.

Unset Pool on the Settings menu opens the Unset Pool dialog.

Unset removes the pool configuration and turns off the application service. When complete, a Success dialog displays.

The Manage Container Images screen lists all container images downloaded on TrueNAS.

Entering characters in the Search field on the screen header filters the images list to only the Image ID or Tags entries matching the entered characters.

Delete Delete in an image row opens the Delete image dialog.

The checkbox to the left of Image ID or an image shows the Batch Operations section and delete button.

Pull Image opens a side panel with options to download specific images to TrueNAS.

Delete Delete in an image row or the Batch Operations section opens the Delete dialog. The dialog displays the selected image(s) to delete.

Target images must not be associated with any running container. Select Confirm and then click Delete to delete the image(s).

Force allows deletion if an image is referenced by multiple tags or stopped containers. Use Force with caution as it can potentially break dependencies or leave images without defined tags.

The Docker Registries screen lists signed-in Docker registry records.

Add Registry opens the Create Docker Registry panel.

Settings opens the Settings screen showing four application train options, the option to add IP addresses and subnets for the application to use, check for Docker image updates, and if the system is equipped with a GPU, to enable TrueNAS to update drivers for that GPU.

Select the checkbox to the left of the train name to add another train to the applications catalog. Train options:

• stable the default train for official apps
• enterprise for apps verified and simplified for Enterprise users, default for enterprise-licensed systems.
• community for community proposed and maintained apps
• test for application in development but not yet released in one of the other three trains.

You must specify at least one train.

The Address Pools shows the current IP address and subnet mask for the network used by applications. Base shows the default IP address and subnet, and Size shows the network size of each docker network that is cut off from the base subnet. Select a predefined range from the dropdown list.

This setting replaces the Kubernetes Settings option for Bind Network in 24.04 and earlier. Use to resolve issues where apps experience issues where the TrueNAS device is not reachable from some networks. Select the network option, or add additional options to resolve the network connection issues.

Install NVIDIA Drivers shows if the system has an NVIDIA GPU installed. Select to enable TrueNAS to manually install drivers for this device. When the TrueNAS Debug Kernel is enabled, NVIDIA drivers are disabled.

Systems with non-NVIDIA GPU devices do not show this option, but these GPUs are selectable in the app installation wizards in the Resources Configuration section for the app.

Check for docker image updates sets TrueNAS to check for docker image updates (default setting).

The Applications table on the Installed screen populates a row for each installed app that shows the current state, and the option to stop the app. Stopped apps show the option to start the app.

After installing an application, the Installed screen populates the Applications table. When returning to the Installed screen, the first application on the list is selected by default. Each application row shows the name, status, and update information for the application.

Click on Application, Status, or Update on the table heading row to sort the table in ascending or descending order.

A yellow badge shows when an update is available. See Update Apps for more information on updating the application.

Search above the Applications table allows entering the name of an app to locate an installed application.

Selecting the checkbox to the left of Applications selects all installed apps and shows the Bulk Actions dropdown list.

The Bulk Action dropdown list allows you to apply actions to one or more applications installed and running on your system.

Select the checkbox to the left of Applications to show the Bulk Actions dropdown menu. Menu options are Start All Selected, Stop All Selected, Update All Selected, and Delete All Selected.

Performing a bulk action update opens a dialog listing the apps with available updates.

Select an application by clicking the radio button to the left of a listed application.

Click the expand icon for listed app to show the Version dropdown and Changelog for the selected version.

Update begins updating the applications one at a time. Apps status changes to STOPPED before it is updated, and then returns to RUNNING after the update completes.

Installed applications have a set of widgets on the Installed screen. Select an application row to view the information widgets for that application. Information in the widgets changes based on the app row selected in the Applications table.

The Application Info widget shows the name, (upstream) app version number, catalog version number, source link for the application, and train name. It includes the Edit, Delete, Roll Back and Web UI buttons for the application. The more_vert dropdown contains the Update and Convert to custom app buttons.

Edit opens an Edit Application configuration screen populated with editable settings also found on the install wizard screen for the application.

more_vert opens a dropdown containing the Update and Convert to custom app buttons.

Update opens a window for the application showing the current version and the new version the update installs.

Convert to custom app opens a Convert to custom app dialog to convert the installed application to a custom YAML app.

Web UI opens the application login or sign-up web page.

Roll Back opens the Roll Back dialog to revert an app to an earlier installed version.

Delete opens the Delete dialog. This deletes the application deployment but does not remove it from the catalog or train in TrueNAS.

The Delete App dialog asks for confirmation to delete the selected application.

Remove iXVolumes deletes hidden app storage from the apps pool. Force-Remove iXVolumes deletes app storage created on TrueNAS 24.04 and migrated to 24.10 or later.

Remove Images prunes Docker images of the deleted app.

Confirm activates the Continue button. Continue initiates the delete operation.

Update shows on the Application Info widget after clicking Update All on the Installed applications header. Both only show if TrueNAS detects an available update for an application. The application widget on the Discover screen also displays an update badge.

Update opens an update window for the application that includes the Version to be updated to dropdown and Changelog options.

Update begins the process and opens a progress dialog that shows the update progress. When complete, the update badge and buttons disappear. The Update state on the application row on the Installed screen changes to Up to date.

Convert to custom app on the more_vert dropdown opens a dialog to convert an installed catalog application to a custom YAML application. Converting to a custom app direct editing to YAML configuration file for the app using the Custom App Screens.

Convert to custom app is a one-time, permanent operation. When converted, an custom application cannot be converted back to a catalog version.

Cancel closes the dialog without converting the application.

Confirm enables the Convert button.

Convert begins the conversion process.

Roll Back on the more_vert dropdown opens a dialog to revert an application to the snapshot of an earlier installed version.

The Version dropdown contains available app versions for roll back. The version numbers displayed are the version of the app in the TrueNAS catalog, equivalent to the Version displayed on the app information card. It is not equal to the App Version or the upstream release version. See Understanding Versions on the TrueNAS Apps Market for more information.

Roll back snapshots restores the application data volume to match the selected version by rolling back to the snapshot for that version. This reverts both the application and app data stored in the apps pool to the exact state from when the snapshot was created.

Roll back snapshots only affects data saved in the apps dataset, such as iXvolume storage. Data in mounted host paths is not rolled back.

Cancel closes the dialog without completing the roll back.

Roll Back begins the operation.

The Workloads widget shows the container information for the selected application. Information includes the number of pods, used ports, number of deployments, stateful sets, and container information. It also shows the Shell, Volume Mounts and View Log icon buttons that provide access to the container pod shell and log screens and mount point windows. The option to access the log and the shell remain available for stopped applications for fully deployed application containers, and for applications in the crashed state.

The Shell Shell button opens the Container Shell screen.

The Volume Mounts folder_open button opens the Volume Mounts dialog.

The View Logs Logs button also opens the Pod Logs screen for the app.

Volume Mounts opens a dialog showing information on the app volume mounts for current and exited volume mounts for the application container. The app has Volume Mount options to open windows for both the running mount point and permissions - exited mount point.

Each Pod Log screen includes a banner with the Application Name, Pod Name and Container Name.

Use the logs to help troubleshoot problems with your container pods.

The Notes widget shows information about the apps, TrueNAS Documentation Hub article locations, links to file bug reports through Jira or GitHub, and where to make feature requests.

View More expands the widget to show more information on application settings. Collapse hides the extra information.

The Application Metadata widget shows application capabilities unique to the application, and Run As Content showing the user and group IDs, the default user and group name, and brief description for the application.

View More expands the widget to show more information on application settings. Collapse hides the extra information.

The Discover screen displays application widgets for the official TrueNAS stable train by default. Users can add the community and enterprise, or test train applications on the Settings screen.

The breadcrumbs at the top of the screen header show links to the previous or the main applications screen. Click a link to open that screen.

Custom App opens the Install iX App screen with an install wizard. more_vert > Install via YAML opens the Add Custom App screen with an advanced YAML editor for deploying apps using Docker Compose.

The Discover screen includes a search field, links to other application management screens, and filters to sort the application widgets displayed. Show All shows all application widgets in the trains added to the Stable catalog. The links are:

• Refresh Charts that executes a job to refresh the catalog applications.
• Manage Installed Apps that opens Installed applications screen.

Filters shows a list of sort categories that alter which application widgets show. Click on a category to select and filter app widgets. Filter information includes the Category, App Name, and Updated Date.

• Category sorts the app widgets by category or functional area. For example, Media, Monitoring, Networking, Productivity. etc.
• App Name sorts app widgets alphabetically (A to Z).
• Updated Date sorts the app widgets by date of update.

TrueNAS 24.10 or later provides two options for installing a third-party application not included in the official catalogs using a Docker image. Custom App opens the Install iX App guided installation wizard. more_vert > Install via YAML opens the Add Custom App screen with an advanced YAML editor for deploying apps using Docker Compose.

See Install Custom App Screens for more information.

Each application widget on the Discover screen opens an information screen with details about that application, a few screenshots of the web UI for the application, and the Install button. Application information shows the app version, GitHub repository link for the image, and date the image was last updated, keywords, the TrueNAS app train, and the app homepage location.

The application information screen shows two widgets:

• Available Resources that show CPU and memory usage the app requires, the app pool, and available space in gigabits.
• Application Info that includes the application version number, link to GitHub repository for the image, and date the image was last updated.

Some applications might also include the Run-As Content and Capabilities widgets.

The screen includes small screenshots of the application website that, when clicked, opens larger versions of the image.

Install opens the installation wizard for the application.

The bottom of the screen includes app widgets for similar applications found in the catalog.

The application Install Application wizard and Edit Application screens show the same settings, but un-editable settings are either not shown or are inactive to prevent edit attempts. The Edit Application screen opens populated with the current settings for the application.

The install and edit wizard screens include a navigation panel on the right of the screen that lists and links to the setting sections. A red triangle with an exclamation point marks the sections with the required settings. An asterisk marks the required fields in a section. You can enter a new setting in fields that include a preprogrammed default.