TrueNAS CORE
TrueNAS Enterprise
TrueNAS SCALE
TrueCommand
Compare Editions
Software Status
FreeNAS
Systems Overview
M-Series
X-Series
R-Series
Mini Series
Download TrueNAS CORE
Download TrueNAS SCALE
Get TrueNAS EnterpriseApplications Screens
9 minute read.
Last Modified 2022-12-13 10:13 -0500The Applications screen displays with Installed Applications displayed by default.
The first time time you select Apps on the main feature navigation panel, the Applications screen displays the Choose a pool for Apps dialog. Select a pool from the dropdown list and then click Choose to set the selected pool as the one applications use for data storage.
The options at the top right of the Applications screen change with the screen tab selected.
The Bulk Action option that displays at the top right of the Installed Applications screen allows you to select more than one, or all installed apps on your system. After selecting the apps, use the other action buttons to either Start, Stop or Delete the selected apps.
Select All places a checkmark in the top left corner of the widget for each installed application. Toggles to Unselect All. Start starts all selected apps, and displays Success dialog for each app after it starts without issue. Stop stops all selected apps and displays a Success dialog for each app after it stops without issue.
The Upgrade option allows you to select multiple apps, and if there are updates available, you can update the apps to the most recent version of the application.
Settings displays at the top right of all four Applications screens, but they are only functional when on the Available Applications screen. Setting options are:
Choose Pool opens the Choose a pool window. Advanced Settings opens the Kubernetes Settings configuration screen. Unset Pool opens a dialog confirming the pool is unset.
Selecting Choose Pool on the Settings list opens a different Choose a pool for Apps window than the one that first displays before you add your first application. Use the Settings > Choose Pool option to change the pool applications use for storage.
Migrate applications to the new pool starts the process of moving your application data from the existing pool to the new pool specified after you click Choose. Select Migrate applications to the new pool if you change your applications pool and want to migrate data from the existing pool to the new pool.
The Advanced Settings option opens the Kubernetes Settings configuration screen.
| Setting | Description |
|---|---|
| Node IP | Select the IP address for the node from the dropdown list. |
| Route v4 Interface | Select the network interface from the dropdown list. |
| Route v4 Gateway | Enter the IP address for the route v4 gateway. |
| Enable Container Image Updates | Select to enable updates of the container image. |
| Enable GPU support | Select to enable GPU support. The maximum number of apps that can use an Intel GPU is five. |
| Enable Integrated Loadbalancer | Select to enable the integrated loadbalancer. The default uses servicelb but if disabled, allows using metallb and allows users to speicfy any IP from the local network. |
| Enable Host Path Safety Checks | Enabled by defualt. TrueNAS SCALE performs safety checks to ensure app host path volumes are secure. |
Settings Requiring Re-Initializtion
| Setting | Description |
|---|---|
| Cluster CIDR | Required. Enter the IP address and CIDR number for the Kubernetes cluster. |
| Service CIDR | Required. Enter the IP address and CIDR number for the Kubernetes service. |
| Cluster DNS IP | Required. Enter the IP address for the cluster DNS. |
The Unset Pool option on the Settings list displays a confirmation dialog. Click UNSET to unset the pool. When complete a Success dialog displays.
Opens a Refreshing counter with status of the refresh options. When complete, the Task Manager displays with the status of each app refresh operation.
Add Catalog at the top of the Manage Catalogs screen opens a warning dialog before it opens the Add Catalog screen.
Click CONTINUE to open the Add Catalog screen.
| Field | Description |
|---|---|
| Catalog Name | enter the name the TrueNAS uses to look up the catalog. For example, truecharts. |
| Force Create | Select to add the catalog to the system even if some trains are unhealthy. |
| Repository | Enter the valid git repository URL. For example, https://github.com/truecharts/catalog. |
| Preferred Trains | The trains TrueNAS uses to retrieve available applications for the catalog. Default is stable (and optionally: incubator). |
| Branch | Specify the git repository branch TrueNAS should use for the catalog. Default is main. |
The Pull Image option at the top right of the Manage Docker Images screen opens the Pull Image screen.
| Setting | Description |
|---|---|
| Image Name | Enter the name of the image to pull. Format for the name is registry/repo/image. |
| Image Tag | Enter the tag of the image. For example, latest. |
These settings are optional, and only needed for private images.
| Setting | Description |
|---|---|
| Username | Enter the input user name. |
| Password | Enter the input user password. |
Launch Docker Image opens the Docker Image wizard where you can configure third-party applications not listed on the Available Applications screen. These docker image options are derived from the Kubernetes container options. See Launch Docker Image Screens for more information.
The No Applications Installed screen displays before you install your first application. View Catalog opens the Available Applications screen.
After installing your application(s), this screen displays the application(s).
Click the on the application widget to open the action options dropdown list. Options are:
- Edit opens the configuration form for the selected application.
- Shell opens the Choose pod window before opening the Applications > Pod Shell screen.
- Logs opens the Choose Log window before opening the Applications > Pod Log screen.
- Delete opens a confirmation dialog.
The Choose Pod window specifies which pod or active container, and the shell commands you want to use when the Applications > Pod Shell screen displays.
| Setting | Description |
|---|---|
| Pods | Required. Select the pod installed from the dropdown list. |
| Containers | Required. Select the container from the dropdown list. |
| Commands | Enter the shell command. |
Select Choose to open the Applications > Pod Shell screen.
The Pod Shell screen allows users to enter TrueNAS CLI commands to access information about their applications.
The following are examples of commands you can enter to access information on an active container. You can also use the System Settings > Shell to access the same information.
To view container namespaces: k3s kubectl get namespaces.
To view pods by namespace: k3s kubectl get -n <NAMESPACE> pods.
To access container shell: k3s kubectl exec -n <NAMESPACE> --stdin --tty <POD> -- /bin/bash.
To view details about all containers: k3s kubectl get pods,svc,daemonsets,deployments,statefulset,sc,pvc,ns,job --all-namespaces -o wide.
To get container status: k3s kubectl describe -n <CONTAINER NAMESPACE> <POD-ID>.
The Logs options opens the Choose Log window.
| Setting | Description |
|---|---|
| Pods | Select the pod from the dropdown list to open the shell screen with the log for this pod. |
| Containers | Select the containers from the dropdown list to include in the log shell screen. |
| Tail Lines | Enter the number of log file lines to include in the shell screen for the log file. |
The Pod Log shell screen displays with the information selected in the Choose Log window.
Use the Set font size slider to increase or decrease the size of the font displayed on the screen. Reconnect re-establishes a connection with the application service. Download Logs downloads the logs to your server.
The Available Applications screen displays the widgets for all applications in the Official catalog.
The Install button on each application card opens the configuration wizard for that application.
Click on the application icon or name to open an appname Application Summary window that includes information on the Catalog, Categories, Train, Status and Versions for that application.
The Manage Catalog screen displays the list of application catalogs installed on TrueNAS SCALE. The Official catalog contains all the applications listed on the Available Applications screen.
The options at the top right of the screen include the Refresh All and Add Catalog options.
The to the right of each catalog displays the catalog options Edit, Refresh, Delete or Summary.
The Edit Catalog screen settings specify the name and train the UI should use to look up the catalog and retrieve applications for the catalog.
The Official catalog name is not editable, but you can change the train.
| Setting | Description |
|---|---|
| Catalog Name | Enter a name TrueNAS should use to look up the catalog. |
| Preferred Train | Select the train(s) the UI should use to retrieve available applications for the catalog from the dropdown list. Options are charts, test, enterprise, and community. |
Opens a Refreshing counter that shows the status of the refresh operation. You can minimze the counter while the process continues.
Opens a confirmation dialog before deleting the catalog. The Official catalog Delete option is inactive. You cannot delete the official catalog.
The Summary option for each catalog listed on Manage Catalogs opens the Name Catalog Summary window where Name is the name of the catalog. The summary displays the catalog status, application and train, and allows you to select the train and status you want to include in the summary.
Add Catalog opens the Add Catalog screen.
| Setting | Description |
|---|---|
| Train | Select the trains you want to include in the catalog summary information. Options are All, charts, test, enterprise or community. |
| Status | Select the statuses you want to include in the catalog summary information. Options are All, Healthy, or Unhealthy. This is useful to filter the summary to locate trains or applications with the Unhealthy status. |
The Manage Docker Images displays a list of Docker image IDs and tags on the system. The list displays Update Available for container images you can update.
Use the to display the options for each Docker image listed. Options are Update Image or Delete. Update Image is only available when the Docker image displays Update Available.
Select Update to open the Choose a tag dialog. Select the image tag and click Choose.
After updating the Docker image, the option becomes inactive until a new update becomes available.