This article covers administering installed applications in TrueNAS. For details on how to set up app storage, configure global settings, and prepare TrueNAS to deploy applications, see Initial Setup. For installing applications from the catalog, see Installing Apps. For custom applications, see Installing Custom Apps.

Installed applications appear on the Installed applications screen. Click on an app row to view Details, including the Application Info, Workloads, Notes, and Application Metadata widgets.

Apps with available upgrades show a yellow circle with an exclamation point on the right side of the Applications table row, and the Installed application screen banner displays an Update or an Update All button. To upgrade an app, select the app row and click Update on the Application Info widget. To upgrade multiple apps, either click the Update All button on the Installed applications banner or select the checkbox to the left of the application row to show the Bulk Actions button. Click Bulk Actions and select Upgrade All to upgrade the apps selected. Upgrade options only show if TrueNAS detects an available update for installed applications.

Update opens an upgrade window 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. A counter dialog opens showing 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 application row. After the app status changes to stopped, click Delete on the Application Info widget for the selected application to open the Delete App dialog.

Select Remove iXVolumes to delete hidden app storage from the apps pool. Select Force-Remove iXVolumes to delete app storage created on TrueNAS 24.04 and migrated to 24.10 or later. Proceed with caution as this option removes both legacy Kubernetes and current Docker data for the application.

Select Remove Images to prune Docker images of the deleted app.

Click Confirm then Continue to delete the application.

Apps on the Installed screen, showing either the Deploying or Running status, can be stopped using the stop button on the Applications table row for the app.

Running apps show the restart icon button that allows you to stop and then restart the application. Click the restart_alt icon button to stop then automatically restart the app.

While on the Installed application screen, click Configuration > Manage Container Images to open the Manage Container Images screen.

Delete images or add new ones from this screen.

To download a custom image, click Pull Image, then enter a valid path and tag to the image.

Enter the path using 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 delete images, click Delete Delete in an image row or the Batch Operations section. The Delete dialog lists the selected image(s) for deletion.

An image cannot be deleted if it is associated with a running container. Select Confirm, then click Delete.

What if I delete an image from a stopped app?

If an image is deleted from a stopped app that is still installed, TrueNAS automatically pulls it again when the app starts.

Force allows deletion when an image has multiple tags or when a stopped container prevents its removal. Use Force with caution, as it can break dependencies or leave images without defined tags.

Installed custom applications show on the Installed applications screen. Many of the management options available for catalog applications are also available for custom apps.

TrueNAS monitors upstream images and alerts when an updated version is available. Update custom applications using the same procedure as catalog applications.

Custom applications installed via YAML do not include the Web UI button on the Application Info widget. To access the web UI for a custom app, navigate to the port on the TrueNAS system, for example, hostname.domain:8080.

Ready to move on? Continue your TrueNAS Apps journey below.

Back to Managing Apps

Learn more about how to find, install, and manage applications in TrueNAS.

Catalog

Browse the full catalog of applications available in TrueNAS!

Back to Getting Started

Review initial setup, securing apps, contributing apps and resources, and more.

Back to Home

View featured applications, the most deployed, and the newest applications available in TrueNAS.