From 3e0c4c4e4ca785d298a66b1110f1d321e1feb215 Mon Sep 17 00:00:00 2001 From: MicJ Date: Tue, 3 Sep 2024 16:56:35 -0400 Subject: [PATCH] PD-1375 Updates to Main Apps Index.md this commit makes changes to the the /truenas_apps/_index.md file. It corrects information and mentions of the ix-apps dataset, when it gets created, and when the old ix-applications dataset exists in 24.10. It adds comments about the change from kubernetes backend to docker compose and links to the 24.10 release notes. --- content/TruenasApps/_index.md | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/content/TruenasApps/_index.md b/content/TruenasApps/_index.md index 0e1977d3f3..e2014ca38c 100644 --- a/content/TruenasApps/_index.md +++ b/content/TruenasApps/_index.md @@ -25,6 +25,9 @@ keywords: TrueNAS applications allow for quick and easy integration of third-party software and TrueNAS. +The TrueNAS applications backend changed in 24.10 to Docker images managed with Docker Compose. +Earlier TrueNAS releases operated with Kubernetes K3 and Helm providing containers for applications. +For more information on this change refer to the [24.10 Release Note]({{< relref "/Content/SCALE/GettingStarted/ScaleReleaseNotes.md" >}}). {{< include file="/static/includes/ProposeArticleChange.md" >}} @@ -85,9 +88,6 @@ Select the pool and click **Save**. If you close the dialog to set the pool late {{< trueimage src="/images/SCALE/Apps/AppsSettingsChoosePool.png" alt="Choosing a Pool for Apps" id="Choosing a Pool for Apps" >}} -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. - If you want to set up new datasets to store your application data in a location separate from other storage on your system, create the datasets before installing the application. For example, create the datasets for the Nextcloud app before installing the app. @@ -224,6 +224,14 @@ The primary mount volumes have two options: * **ixVolume** that creates a storage volume inside the **ix-apps** dataset. This is the default setting. * **Host Path** that allows you to select an existing dataset created for the application. Shows additional fields to select the path to the dataset and add the mount point. +{{< hint type="information" title="ix-apps Dataset" >}} +The **ix-apps** dataset is for internal use only. + +TrueNAS systems with applications deployed that upgrade from earlier releases to 24.10 continue to see the **ix-Applications** dataset on the pool chosen for applications to use. +New installs or systems upgrading where applications are not deployed and a pool is not chosen for apps use the hidden **ix-apps** dataset. +Choosing the pool for apps to use, creates this dataset to store all container-related data. +{{< /hint >}} + If adding an additional storage volume, click **Add** to configure additional storage volumes for the application to use in addition to the main storage volume (dataset). The three storage options are: * **ixVolume**