diff --git a/content/GettingStarted/SCALEReleaseNotes.md b/content/GettingStarted/SCALEReleaseNotes.md
index ed2abb9fb4..f4a40607a6 100644
--- a/content/GettingStarted/SCALEReleaseNotes.md
+++ b/content/GettingStarted/SCALEReleaseNotes.md
@@ -4,12 +4,7 @@ description: "Highlights, change log, and known issues for TrueNAS 24.10 release
weight: 10
related: false
---
-{{< header logo="/images/tn-scale-logo.png" logo_alt="TrueNAS Logo" version="24.10 Electric Eel" icon="" icon_alt="" >}}
-
-{{< hint type="tip" title="24.10 Early Release Documentation" >}}
-This page tracks the latest development roadmap and release notes for the next upcoming TrueNAS major version, 24.10 (Electric Eel).
-The stable [24.04 (Dragonfish) release notes](https://www.truenas.com/docs/scale/24.04/gettingstarted/scalereleasenotes/) are available with documentation for that version.
-{{< /hint >}}
+{{< header logo="/images/tn-openstorage-logo.png" logo_alt="TrueNAS Logo" version="24.10 Electric Eel" icon="/images/SCALE_Electric_Eel_Icon.png" icon_alt="Electric Eel Icon" >}}
## Features
@@ -17,9 +12,7 @@ The stable [24.04 (Dragonfish) release notes](https://www.truenas.com/docs/scale
## Obtaining a Release
-{{< include file="/static/includes/EarlyReleaseWarning.md" >}}
-
-24.10 (Electric Eel) early releases (BETA and RC) are available from the [TrueNAS download page](https://www.truenas.com/download-truenas-scale/).
+24.10 (Electric Eel) is available from the [TrueNAS download page](https://www.truenas.com/download-truenas-scale/).
For adventurous users that want to experiment with the latest feature development, nightly build [.iso](https://download.truenas.com/truenas-scale-electriceel-nightly/) and [.update](https://update.sys.truenas.net/scale/TrueNAS-SCALE-ElectricEel-Nightlies/) files are available.
@@ -29,7 +22,7 @@ More details are available from [Software Releases](https://www.truenas.com/docs
{{< include file="/static/includes/ReleaseScheduleWarning.md" >}}
-{{< releaselist name=scale-releases defaultTab=3 >}}
+{{< releaselist name=scale-releases defaultTab=2 >}}
{{< expand "Software Lifecycle" "v" >}}
{{< include file="/static/includes/LifecycleTable.md" >}}
@@ -48,41 +41,34 @@ More details are available from [Software Releases](https://www.truenas.com/docs
* 24.10 moves the applications backend from Kubernetes to Docker ([announcement](https://forums.truenas.com/t/the-future-of-electric-eel-and-apps/5409)).
- * All applications available from official trains in 24.04 are available to install in 24.10.
+ * All applications available from official catalogs in 24.04 are available to install in 24.10.
Supported catalog applications automatically migrate to Docker deployments on upgrade from from 24.04 (Dragonfish) to Electric Eel.
-
- * Custom application installs are enabled in 24.10-RC.1.
- There are two options to install a custom application from the **Applications > Discover** screen for the RC.1 release:
-
- * Click **Custom App** to install an application using a Docker Compose YAML file.
- Note: applications installed using the **Custom App** button are not editable via the TrueNAS UI in 24.10-RC.1 (see [Known Issues](#2410-rc1-known-issues) below).
-
- * Select the **Ix-app** application widget on the **Discover** screen, then click **Install** on the information screen to deploy a docker image with a simple installation wizard.
- Applications installed using this option can be edited in the TrueNAS UI.
-
- Additional development for the 24.10.0 release version will simplify these options so that the **Custom App** button will open the install wizard and also contain a dropdown option to **Install via YAML**.
- * Automatic app migration on upgrade from 24.04 is generally at parity for all applications.
- A few applications, such as home-assistant, might require manual migration steps, depending on the options enabled in 24.04.
- See the [Parity Status with truenas/charts](https://github.com/truenas/apps?tab=readme-ov-file#parity-status-with-truenascharts) chart from the /truenas/apps/ github repository for more information.
+ * Custom applications based on Docker images can be installed using the installation wizard or a Docker Compose YAML file.
+ See [Installing Custom Applications](https://www.truenas.com/docs/truenasapps/usingcustomapp/) for more information.
+
+ * Automatic app migration on upgrade from 24.04 is at parity for all catalog applications.
+ A few applications might require manual migration steps, depending on the options enabled in 24.04.
+ For more information, see the comments for [Home Assistant](https://github.com/truenas/apps/pull/492) and [Tailscale](https://github.com/truenas/apps/pull/641).
In the event of a migration failure, configuration data for applications that do not automatically migrate is retained in the ixapplications dataset.
You can re-initiate migration of previously-installed Kubernetes apps to Docker at any time after upgrading to Electric Eel.
From a shell session enter {{< cli >}}midclt call -job k8s_to_docker.migrate *poolname*{{< /cli >}}, where *poolname* is the name of the applications pool.
- * Custom applications installed using the TrueNAS UI in 24.04 automatically migrate on upgrade to 24.10.
-
- * Applications from third-party catalogs, such as TrueCharts, do not support automatic migration to 24.10.
- Migration of third-party applications generally requires manual data backup and redeployment.
-
- Third-party catalogs are provided, maintained, and supported by individuals or organizations outside of iXsystems.
- Refer to the catalog maintainer or the [TrueNAS Community forums](https://forums.truenas.com/) for migration support.
-
- {{< hint type=important title="Migrating Apps with Host Path ACLs" >}}
- Users with applications installed on 24.04 using host path volume mounts and **ACL Entries** defined in the app configuration screen must go to the app edit screen and set the **Force Flag** checkbox under **ACL Options** before updating to 24.10. This ensures the app fully migrates and doesn't encounter issues when the mount point has existing data.
- {{< /hint >}}
+ Custom applications installed using the TrueNAS UI in 24.04 automatically migrate on upgrade to 24.10.
-* Starting in 24.10, TrueNAS does not install a default NVIDIA driver.
+ * To prepare applications for migration, address the following configurations before upgrading to 24.10:
+
+ {{< truetable >}}
+ | Configuration | Action Needed |
+ |-----------|-------------|
+ | Host Path ACLs | Users with applications installed on 24.04 using host path volume mounts and **ACL Entries** defined in the app configuration screen must go to the app edit screen and set the **Force Flag** checkbox under **ACL Options** before updating to 24.10. This ensures the app fully migrates and doesn't encounter issues when the mount point has existing data. |
+ | Encrypted Root Dataset | Applications do not migrate to 24.10 if the ix-applications dataset is configured on a pool with an encrypted root dataset (see [NAS-131561](https://ixsystems.atlassian.net/browse/NAS-131561)). Relocate installed applications to an unencrypted pool on 24.04 before attempting to upgrade to 24.10. |
+ | Third Party Applications | Applications from third-party catalogs, such as TrueCharts, do not support automatic migration to 24.10. Migration of third-party applications generally requires manual data backup and redeployment.
Third-party catalogs are provided, maintained, and supported by individuals or organizations outside of iXsystems. Refer to the catalog maintainer or the [TrueNAS Community forums](https://forums.truenas.com/) for migration support. |
+ | Container Dependent Network Settings | Applications will not migrate if TrueNAS network settings are configured to depend on any client container or application hosted on the TrueNAS system, such as DNS services, proxy networks, firewalls, and routers (see [NAS-131553](https://ixsystems.atlassian.net/browse/NAS-131553)). This is an unsupported configuration because TrueNAS cannot access the necessary networks during boot if the client container has not started. |
+ {{< /truetable >}}
+
+* Starting in 24.10, TrueNAS does not include a default NVIDIA GPU driver and instead provides a simple NVIDIA driver download option in the web interface.
This allows for driver updates between TrueNAS release versions.
Users can enable driver installation from the **Installed** applications screen.
@@ -98,7 +84,7 @@ More details are available from [Software Releases](https://www.truenas.com/docs
* SMB audit log entries are omitted by default from the **System > Audit** screen.
To view SMB audit results, go to **System > Services** and click receipt_long **Audit Logs** for the SMB service or use advanced search on the main **Audit** screen to query SMB events.
-### Upgrade Paths (Anticipated)
+### Upgrade Paths
{{< include file="/static/includes/24.10UpgradeMethods.md" >}}
@@ -120,13 +106,16 @@ Enterprise customers with HA systems should contact iXsystems Support for assist
{{< /enterprise >}}
When attempting to migrate from TrueNAS 13.0 (or 13.3 for community members), the general recommendation is to back up the system configuration file and use an **.iso** file to fresh install TrueNAS.
+Upgrade your system to the latest publicly-available 13.0-U6.2 (or later) release before attempting to migrate.
After install, restore the system configuration and import the pools.
Depending on the specific system configuration, this can be a straightforward or complicated process.
See the [Migration articles]({{< relref "/GettingStarted/Migrate/_index.md" >}}) for cautions and notes about differences between each software and the migration process.
-You must either clean install using an iso or use an upgrade file to migrate a TrueNAS 13.0 (or 13.3 for community users) system to 24.04 (Dragonfish) before upgrading to 24.10 (Electric Eel).
-Enterprise customers should [contact Support](https://www.truenas.com/docs/scale/gettingstarted/migrate/migratecorehatoscaleha/#expand-1-Enterprise%20HA%20Migrations) for assistance with migrating.
+The only path to side-grade or migrate from 13.0-U6.2 or 13.3 is to install or upgrade to 24.04 (latest).
+TrueNAS 24.10 and later releases do not support migrations from 13.X. These migrations cannot be done, and either fail or result in error conditions that cannot be resolved.
+Download the iso for the latest maintenance release of TrueNAS 24.04 (see [Software Releases](https://www.truenas.com/docs/softwarereleases/)) and follow the instruction articles in this section.
+Enterprise customers should [contact Support](https://www.truenas.com/docs/scale/gettingstarted/migrate/migratecorehatoscaleha/) for assistance with migrating.
## Component Versions
Click the component version number to see the latest release notes for that component.
@@ -152,8 +141,48 @@ Any new feature flags introduced since the previous OpenZFS version that was int
For more details on feature flags, see [OpenZFS Feature Flags](https://openzfs.github.io/openzfs-docs/Basic%20Concepts/Feature%20Flags.html) and [OpenZFS zpool-feature.7](https://openzfs.github.io/openzfs-docs/man/7/zpool-features.7.html).
+## 24.10.0 Changelog
+
+**October 29, 2024**
+
+iXsystems is pleased to release TrueNAS 24.10.0!
+This is the first stable release of TrueNAS SCALE 24.10 (Electric Eel).
+It includes numerous software component updates and polished features, as well as fixes for issues discovered in 24.10-RC.1 and 24.10-RC.2.
+
+Notable changes:
+
+* True Cloud Backup Tasks ([NAS-127165](https://ixsystems.atlassian.net/browse/NAS-127165)).
+* Replace nslcd with sssd ([NAS-127073](https://ixsystems.atlassian.net/browse/NAS-127073)).
+* Dashboard Improvements ([NAS-127217](https://ixsystems.atlassian.net/browse/NAS-127217)).
+* UI Table Improvements ([NAS-127222](https://ixsystems.atlassian.net/browse/NAS-127222)).
+* UI Global Search ([NAS-127224](https://ixsystems.atlassian.net/browse/NAS-127224)).
+* Rewrite enclosure plugin in 24.10 to match performance improvements in 13.3 ([NAS-123474](https://ixsystems.atlassian.net/browse/NAS-123474)).
+* Prevent phantom partitions that TrueNAS erroneously reported as disconnected pools ([NAS-131171](https://ixsystems.atlassian.net/browse/NAS-131171)).
+* Revised Docker networking logic for applications ([NAS-131617](https://ixsystems.atlassian.net/browse/NAS-131617)).
+* Enable editing of custom YAML applications ([NAS-131147](https://ixsystems.atlassian.net/browse/NAS-131147)).
+* Prevent the TrueNAS UI from sending an improper payload for the Outboard Activity option when re-saving an edit to global network settings ([NAS-131787](https://ixsystems.atlassian.net/browse/NAS-131787)).
+* When moving from an existing applications pool to a new pool, TrueNAS does not present the option to **Migrate applications to the new pool** because the underlying functionality is not present in the new Docker apps framework ([NAS-131610](https://ixsystems.atlassian.net/browse/NAS-131610)). Users who need to redeploy the applications pool can either choose to leave existing applications on the previous location, remove existing applications and reinstall on the new pool, or manually relocate and clean up data.
+* **Documentation Hub Update**: To reflect the continuing process of application maintenance and updates as separate from TrueNAS major version releases, all application Tutorials are moved from the Tutorials section in TrueNAS version documentation to a dedicated and unversioned [TrueNAS Apps](https://www.truenas.com/docs/truenasapps/) section.
+
+ Community contributions to TrueNAS Apps documentation are highly encouraged!
+ The [Community Apps](https://www.truenas.com/docs/truenasapps/communityapps/) documentation is pre-populated with placeholder templates for each application available in the TrueNAS Community train and ready to accept Pull Requests.
+ See [Contributing to TrueNAS Application Documentation](https://www.truenas.com/docs/contributing/applications/#contributing-to-truenas-application-documentation) for more information.
+
+Click here for the full changelog of completed Jira tickets that are included in the 24.10.0 release.
+{{< include file="/static/includes/JiraFilterInstructions.md" >}}
+
+### 24.10.0 Known Issues
+
+* Replication task (and possibly other Backup Task) logs aren't properly downloading for non-full admin users ([NAS-132031](https://ixsystems.atlassian.net/browse/NAS-132031)).
+ A full admin user can download these task logs and a fix for admin users with fewer permissions is pending in the 24.10.1 release.
+* Some users report that after rebooting TrueNAS, the Installed applications screen does not display the apps that are installed and states **Applications are not running**.
+ Users encountering this issue can refresh the web page to correct it.
+
+Click here to see the latest information on Jira about public issues discovered in 24.10.0 that are being resolved in a future TrueNAS release.
+
## 24.10-RC.2 Changelog
+{{< expand "Click to expand" "v" >}}
{{< hint type=warning title="Early Release Software" >}}
Early releases are intended for testing and feedback purposes.
Do not use early release software for critical tasks.
@@ -169,9 +198,11 @@ Notable changes:
* Revised Docker networking logic to prevent users with 15 or more applications installed encountering network exhaustion, which resulted in the apps service failing to initialize ([NAS-131485](https://ixsystems.atlassian.net/browse/NAS-131485)).
Please use the 24.10-RC.1 Jira filter links below to see the full changelog and known issues related to the 24.10 release candidates.
+{{< /expand >}}
## 24.10-RC.1 Changelog
+{{< expand "Click to expand" "v" >}}
{{< hint type=warning title="Early Release Software" >}}
Early releases are intended for testing and feedback purposes.
Do not use early-release software for critical tasks.
@@ -212,7 +243,7 @@ Notable changes:
* Fix issues with user.update endpoint ([NAS-130696](https://ixsystems.atlassian.net/browse/NAS-130696)).
-Click here for the full changelog of completed tickets that are included in the 24.10-RC.1 release.
+Click here for the full changelog of completed Jira tickets that are included in the 24.10-RC.1 release.
{{< include file="/static/includes/JiraFilterInstructions.md" >}}
### 24.10-RC.1 Known Issues
@@ -251,7 +282,8 @@ Notable changes:
* Development of the new RAIDZ pool expansion feature is ongoing, with fixes for known issues expected in the 24.10.0 release ([NAS-131207](https://ixsystems.atlassian.net/browse/NAS-131207) and [NAS-131028](https://ixsystems.atlassian.net/browse/NAS-131028)).
-Click here to see the latest information about public issues discovered in 24.10-RC.1 that are being resolved in a future TrueNAS release.
+Click here to see the latest information on Jira about public issues discovered in 24.10-RC.1 that are being resolved in a future TrueNAS release.
+{{< /expand >}}
## 24.10-BETA.1 Changelog
@@ -311,7 +343,7 @@ Notable changes:
* Fix management of SNMPv3 user ([NAS-128335](https://ixsystems.atlassian.net/browse/NAS-128335)).
-Click here for the full changelog of completed tickets that are included in the 24.10-BETA.1 release.
+Click here for the full changelog of completed Jira tickets that are included in the 24.10-BETA.1 release.
{{< include file="/static/includes/JiraFilterInstructions.md" >}}
### 24.10-BETA.1 Known Issues
@@ -332,5 +364,5 @@ Notable changes:
* On the virtual machine creation screen, a validation error displays if a configured GPU device is not valid for use in the VM. However, in some cases it can be possible to continue and create the VM with an invalid GPU configuration ([NAS-130754](https://ixsystems.atlassian.net/browse/NAS-130754)). If you receive a GPU validation error during VM creation, remove or correct the invalid GPU before creating the VM.
-Click here to see the latest information about public issues discovered in 24.10-BETA.1 that are being resolved in a future TrueNAS release.
+Click here to see the latest information on Jira about public issues discovered in 24.10-BETA.1 that are being resolved in a future TrueNAS release.
{{< /expand >}}
diff --git a/content/SCALETutorials/Network/AddingGlobalConf.md b/content/SCALETutorials/Network/AddingGlobalConf.md
index e7910d0600..45cc4b759e 100644
--- a/content/SCALETutorials/Network/AddingGlobalConf.md
+++ b/content/SCALETutorials/Network/AddingGlobalConf.md
@@ -10,12 +10,7 @@ Use the **Global Configuration Settings** screen to add general network settings
To add new or change existing network interfaces see [Managing Interfaces]({{< relref "/SCALETutorials/Network/Interfaces/_index.md" >}}).
-{{< hint type=warning >}}
-**Disruptive Change**
-
-You can lose your TrueNAS connection if you change the network interface that the web interface uses!
-You might need command line knowledge or physical access to the TrueNAS system to fix misconfigured network settings.
-{{< /hint >}}
+{{< include file="/static/includes/NetworkWarn.md" >}}
## Adding Network Settings
diff --git a/content/SCALETutorials/Network/Interfaces/SettingUpStaticIPs.md b/content/SCALETutorials/Network/Interfaces/SettingUpStaticIPs.md
index 040cede9e0..473abf6671 100644
--- a/content/SCALETutorials/Network/Interfaces/SettingUpStaticIPs.md
+++ b/content/SCALETutorials/Network/Interfaces/SettingUpStaticIPs.md
@@ -12,13 +12,7 @@ tags:
This article describes setting up a network interface with a static IP address or changing the main interface from a DHCP-assigned to a manually-entered static IP address.
You must know the DNS name server and default gateway addresses for your IP address.
-{{< hint type=warning >}}
-**Disruptive Change!**
-
-You can lose your TrueNAS connection if you change the network interface that the web interface uses!
-
-Command line knowledge and physical access to the TrueNAS system are often required to fix misconfigured network settings.
-{{< /hint >}}
+{{< include file="/static/includes/NetworkWarn.md" >}}
{{< include file="/static/includes/MultipleInterfacesOnNetwork.md" >}}
diff --git a/content/SCALETutorials/Network/Interfaces/_index.md b/content/SCALETutorials/Network/Interfaces/_index.md
index 089b7bfdf1..6578448144 100644
--- a/content/SCALETutorials/Network/Interfaces/_index.md
+++ b/content/SCALETutorials/Network/Interfaces/_index.md
@@ -76,11 +76,7 @@ After making the changes, click **Save**.
Test the change as described in [Testing Network Interface Changes](#testing-network-interface-changes).
-{{< hint type=warning >}}
-If you delete the primary network interface you can lose your TrueNAS connection and the ability to communicate with the TrueNAS through the web interface!
-
-If you save the changes you lose access to the UI, you might need command line knowledge or physical access to the TrueNAS system to fix misconfigured network settings.
-{{< /hint >}}
+{{< include file="/static/includes/NetworkWarn.md" >}}
## Deleting an Interface
Click the delete icon for the interface.
diff --git a/content/SCALETutorials/Network/ManagingGlobalConfig.md b/content/SCALETutorials/Network/ManagingGlobalConfig.md
index 430333ea77..0e81242959 100644
--- a/content/SCALETutorials/Network/ManagingGlobalConfig.md
+++ b/content/SCALETutorials/Network/ManagingGlobalConfig.md
@@ -9,12 +9,7 @@ tags:
Use the **Global Configuration Settings** screen to manage existing general network settings like the default gateway and DNS servers.
Set DHCP to assign the IPv4 address, or manually set a static IP address, add IP address aliases, and set up services to allow external communication.
-{{< hint type=warning >}}
-**Disruptive Change**
-
-You can lose your TrueNAS connection if you change the network interface that the web interface uses!
-You might need command line knowledge or physical access to the TrueNAS system to fix misconfigured network settings.
-{{< /hint >}}
+{{< include file="/static/includes/NetworkWarn.md" >}}
{{< expand "Tutorial Video" "v" >}}
diff --git a/content/SCALEUIReference/Apps/InstallCustomAppScreens.md b/content/SCALEUIReference/Apps/InstallCustomAppScreens.md
index 86643375ca..2123c0e075 100644
--- a/content/SCALEUIReference/Apps/InstallCustomAppScreens.md
+++ b/content/SCALEUIReference/Apps/InstallCustomAppScreens.md
@@ -6,8 +6,6 @@ tags:
- customapp
---
-{{< include file="/static/includes/apps/CustomAppEE.md" >}}
-
**Custom App** on the [**Discover**]({{< relref "/SCALEUIReference/Apps/_index.md" >}}) screen opens the **[Install iX App](#install-ix-app-screen)** guided installation wizard.
more_vert > **Install via YAML** opens the **[Add Custom App](#add-custom-app-screen)** screen with an advanced YAML editor for deploying apps using Docker Compose.
diff --git a/content/SCALEUIReference/Network/GlobalConfigurationScreens.md b/content/SCALEUIReference/Network/GlobalConfigurationScreens.md
index e72b8c91d9..d28e182e43 100644
--- a/content/SCALEUIReference/Network/GlobalConfigurationScreens.md
+++ b/content/SCALEUIReference/Network/GlobalConfigurationScreens.md
@@ -16,12 +16,7 @@ The SCALE information dislplayed the **Global Configuration** widget is the equi
Use **Settings** to display the **Global Configuration** screen where you can add or change global network settings.
-{{< hint type=warning >}}
-**Disruptive Change**
-
-You can lose your TrueNAS connection if you change the network interface that the web interface uses!
-You might need command line knowledge or physical access to the TrueNAS system to fix misconfigured network settings.
-{{< /hint >}}
+{{< include file="/static/includes/NetworkWarn.md" >}}
diff --git a/content/_index.md b/content/_index.md
index 490e8dc3ab..3e744bc62a 100644
--- a/content/_index.md
+++ b/content/_index.md
@@ -19,7 +19,7 @@ div.docs-read_mod {display: none;}
h1 {display:none;}
-{{< header logo="/images/tn-scale-logo.png" logo_alt="TrueNAS SCALE Logo" version="24.10 Electric Eel" icon="" icon_alt="" >}}
+{{< header logo="/images/tn-openstorage-logo.png" logo_alt="TrueNAS Logo" version="24.10 Electric Eel" icon="/images/SCALE_Electric_Eel_Icon.png" icon_alt="Electric Eel Icon" >}}
{{< include file="/static/includes/24.10FeatureList.md" >}}
diff --git a/data/properties/scale-downloads.yaml b/data/properties/scale-downloads.yaml
index af21488569..c904143b5a 100644
--- a/data/properties/scale-downloads.yaml
+++ b/data/properties/scale-downloads.yaml
@@ -5,83 +5,85 @@ product: "TrueNAS SCALE"
title: "SCALE™ | Enterprise™"
majorVersions:
- lifecycle: "Archive"
- majorVersion: "22.02 (Angelfish)"
- releaseName: "Angelfish"
- releases:
- - name: "22.02.4 (Angelfish)"
- link: "https://download.truenas.com/TrueNAS-SCALE-Angelfish/22.02.4/"
- date: "2022-09-27"
- majorVersion: "22.12 (Bluefin)"
- releaseName: "Bluefin"
- releases:
- - name: "22.12.4.2"
- link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.4.2/"
- date: "2023-10-13"
- - name: "22.12.4.1"
- link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.4.1/"
- date: "2023-10-12"
- - name: "22.12.4"
- link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.4/"
- date: "2023-10-03"
- - name: "22.12.3.3"
- link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.3.3/"
- date: "2023-07-25"
- - name: "22.12.3.2"
- link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.3.2/"
- date: "2023-07-05"
- - name: "22.12.3.1"
- link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.3.1/"
- date: "2023-06-20"
- - name: "22.12.3"
- link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.3/"
- date: "2023-06-13"
- - name: "22.12.2"
- link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.2/"
- date: "2023-03-11"
- - name: "22.12.1"
- link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.1/"
- date: "2023-02-21"
- - name: "22.12.0"
- link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.0/"
- date: "2022-12-13"
+ majorVersions:
+ - majorVersion: "Final Release Versions"
+ releaseName: "Final"
+ - majorVersion: "23.10 (Cobia)"
+ releaseName: "Cobia"
+ releases:
+ - name: "23.10.2"
+ link: "https://download.truenas.com/TrueNAS-SCALE-Cobia/23.10.2/"
+ date: "2024-02-22"
+ # - name: "23.10.1.3"
+ # link: "https://download.truenas.com/TrueNAS-SCALE-Cobia/23.10.1.3/"
+ # date: "2024-01-24"
+ # - name: "23.10.1.2 (not released)"
+ # link: ""
+ # date: ""
+ # - name: "23.10.1.1"
+ # link: "https://download.truenas.com/TrueNAS-SCALE-Cobia/23.10.1.1/"
+ # date: "2024-01-16"
+ # - name: "23.10.1"
+ # link: "https://download.truenas.com/TrueNAS-SCALE-Cobia/23.10.1/"
+ # date: "2023-12-19"
+ # - name: "23.10.0.1"
+ # link: "https://download.truenas.com/TrueNAS-SCALE-Cobia/23.10.0.1/"
+ # date: "2023-10-31"
+ # - name: "23.10.0"
+ # link: "https://download.truenas.com/TrueNAS-SCALE-Cobia/23.10.0/"
+ # date: "2023-10-24"
+ - majorVersion: "22.12 (Bluefin)"
+ releaseName: "Bluefin"
+ releases:
+ - name: "22.12.4.2"
+ link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.4.2/"
+ date: "2023-10-13"
+ # - name: "22.12.4.1"
+ # link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.4.1/"
+ # date: "2023-10-12"
+ # - name: "22.12.4"
+ # link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.4/"
+ # date: "2023-10-03"
+ # - name: "22.12.3.3"
+ # link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.3.3/"
+ # date: "2023-07-25"
+ # - name: "22.12.3.2"
+ # link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.3.2/"
+ # date: "2023-07-05"
+ # - name: "22.12.3.1"
+ # link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.3.1/"
+ # date: "2023-06-20"
+ # - name: "22.12.3"
+ # link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.3/"
+ # date: "2023-06-13"
+ # - name: "22.12.2"
+ # link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.2/"
+ # date: "2023-03-11"
+ # - name: "22.12.1"
+ # link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.1/"
+ # date: "2023-02-21"
+ # - name: "22.12.0"
+ # link: "https://download.truenas.com/TrueNAS-SCALE-Bluefin/22.12.0/"
+ # date: "2022-12-13"
+ - majorVersion: "22.02 (Angelfish)"
+ releaseName: "Angelfish"
+ releases:
+ - name: "22.02.4 (Angelfish)"
+ link: "https://download.truenas.com/TrueNAS-SCALE-Angelfish/22.02.4/"
+ date: "2022-09-27"
- lifecycle: "Previous"
- majorVersion: "23.10 (Cobia)"
- releaseName: "Cobia"
- releases:
- - name: "23.10.2"
- link: "https://download.truenas.com/TrueNAS-SCALE-Cobia/23.10.2/"
- date: "2024-02-22"
- - name: "23.10.1.3"
- link: "https://download.truenas.com/TrueNAS-SCALE-Cobia/23.10.1.3/"
- date: "2024-01-24"
- - name: "23.10.1.2 (not released)"
- link: ""
- date: ""
- - name: "23.10.1.1"
- link: "https://download.truenas.com/TrueNAS-SCALE-Cobia/23.10.1.1/"
- date: "2024-01-16"
- - name: "23.10.1"
- link: "https://download.truenas.com/TrueNAS-SCALE-Cobia/23.10.1/"
- date: "2023-12-19"
- - name: "23.10.0.1"
- link: "https://download.truenas.com/TrueNAS-SCALE-Cobia/23.10.0.1/"
- date: "2023-10-31"
- - name: "23.10.0"
- link: "https://download.truenas.com/TrueNAS-SCALE-Cobia/23.10.0/"
- date: "2023-10-24"
- - lifecycle: "Current"
majorVersion: "24.04 (Dragonfish)"
releaseName: "Dragonfish"
releases:
+ - name: "24.04.2.3"
+ link: "https://download.truenas.com/TrueNAS-SCALE-Dragonfish/24.04.2.3/"
+ date: "2024-10-10"
- name: "24.04.2.2"
link: "https://download.truenas.com/TrueNAS-SCALE-Dragonfish/24.04.2.2/"
date: "2024-09-17"
- name: "24.04.2.1"
link: "https://download.truenas.com/TrueNAS-SCALE-Dragonfish/24.04.2.1/"
date: "2024-09-11"
- - name: "24.04.2"
- link: "https://download.truenas.com/TrueNAS-SCALE-Dragonfish/24.04.2/"
- date: "2024-07-09"
- name: "24.04.1.1"
link: "https://download.truenas.com/TrueNAS-SCALE-Dragonfish/24.04.1.1/"
date: "2024-05-29"
@@ -103,17 +105,29 @@ majorVersions:
- name: "24.04 (Dragonfish) Nightly .update"
link: "https://update.sys.truenas.net/scale/TrueNAS-SCALE-Dragonfish-Nightlies/"
date: ""
-
- - lifecycle: "Next"
+ - lifecycle: "Current"
majorVersion: "24.10 (Electric Eel)"
releaseName: "Electric Eel"
releases:
+ - name: "24.10.0"
+ link: "https://download.truenas.com/TrueNAS-ElectricEel-RC/24.10.0/"
+ date: "2024-10-29"
+ - name: "24.10-RC.2"
+ link: "https://download.truenas.com/TrueNAS-ElectricEel-RC/24.10-RC.2/"
+ date: "2024-10-04"
+ - name: "24.10-RC.1"
+ link: "https://download.truenas.com/TrueNAS-ElectricEel-RC/24.10-RC.1/"
+ date: "2024-10-02"
- name: "24.10-BETA.1"
link: "https://download.truenas.com/truenas-scale-electriceel-BETA/24.10-BETA.1/"
date: "2024-08-29"
- name: "24.10 (Electric Eel) Nightly .iso"
link: "https://download.truenas.com/truenas-scale-electriceel-nightly/"
date: ""
- - name: "24.10 (Electric Eel) Nightly .update"
- link: "https://update.sys.truenas.net/scale/TrueNAS-SCALE-ElectricEel-Nightlies/"
- date: ""
+ - lifecycle: "Next"
+ majorVersion: "25.04 (Fangtooth)"
+ releaseName: "Fangtooth"
+ releases:
+ - name: "25.04 (Fangtooth) Nightly .iso"
+ link: "https://download.truenas.com/truenas-scale-fangtooth-nightly/"
+ date: ""
\ No newline at end of file
diff --git a/data/properties/scale-releases.yaml b/data/properties/scale-releases.yaml
index d03146d137..f426abea66 100644
--- a/data/properties/scale-releases.yaml
+++ b/data/properties/scale-releases.yaml
@@ -5,39 +5,49 @@ product: "TrueNAS SCALE"
title: "SCALE™ | Enterprise™"
majorVersions:
- lifecycle: "Previous"
- name: "TrueNAS SCALE 23.10 - Cobia"
- releaseName: "Cobia"
- releases:
- - name: "23.10.2"
- type: "Maintenance"
- link: "https://www.truenas.com/docs/scale/23.10/gettingstarted/scalereleasenotes/"
- releaseDate: "2024-02-22"
- latest: true
- - lifecycle: "Current"
name: "TrueNAS SCALE 24.04 - Dragonfish"
releaseName: "Dragonfish"
releases:
- - name: "24.04.2.2"
+ - name: "24.04.2.3"
type: "Maintenance"
- link: "https://www.truenas.com/docs/scale/24.04/gettingstarted/scalereleasenotes/#240422-changelog"
- releaseDate: "2024-09-17"
+ link: "https://www.truenas.com/docs/scale/24.04/gettingstarted/scalereleasenotes/#240423-changelog"
+ releaseDate: "2024-10-10"
latest: true
- - lifecycle: "Next"
+ - lifecycle: "Current"
name: "TrueNAS SCALE 24.10 - Electric Eel"
releaseName: "Electric Eel"
releases:
- - name: "24.10-RC.2"
- type: "Early"
- link: "https://www.truenas.com/docs/scale/24.10/gettingstarted/scalereleasenotes/#2410-rc2-changelog"
- releaseDate: "2024-10-04"
+ - name: "24.10.0"
+ type: "Stable"
+ link: "https://www.truenas.com/docs/scale/24.10/gettingstarted/scalereleasenotes/#24100-changelog"
+ releaseDate: "2024-10-29"
latest: true
- - name: "24.10 Nightlies"
+ - name: "24.10.1"
+ type: "Maintenance"
+ link: ""
+ releaseDate: "2024-12-12"
+ latest: false
+ - lifecycle: "Next"
+ name: "TrueNAS SCALE 25.04 - Fangtooth"
+ releaseName: "Fangtooth"
+ releases:
+ - name: "25.04 Nightlies"
type: "Experimental"
- link: "https://www.truenas.com/docs/scale/24.10/gettingstarted/scalereleasenotes/"
- releaseDate: "2024-01-23"
- latest: True
- - name: "24.10.0"
+ link: "https://www.truenas.com/docs/scale/25.04/gettingstarted/scalereleasenotes/"
+ releaseDate: "2024-08-13"
+ latest: true
+ - name: "25.04-BETA.1"
+ type: "Early"
+ link: ""
+ releaseDate: "2025-02-11"
+ latest: false
+ - name: "25.04-RC.1"
+ type: "Early"
+ link: ""
+ releaseDate: "2025-03-11"
+ latest: false
+ - name: "25.04.0"
type: "Stable"
link: ""
- releaseDate: "2024-10-29"
+ releaseDate: "2025-04-15"
latest: false
diff --git a/layouts/partials/page-header.html b/layouts/partials/page-header.html
index a8eaf46372..4d41c92256 100644
--- a/layouts/partials/page-header.html
+++ b/layouts/partials/page-header.html
@@ -57,12 +57,12 @@
{{ end }}
-
+
-
TrueNAS Early Release Documentation
+
TrueNAS Stable Version Documentation
- This content follows TrueNAS 24.10 (Electric Eel) development versions. Early release software is intended for testing purposes only.
Use the Product and Version selectors above to view content specific to a stable software release.
+ This content follows TrueNAS 24.10 (Electric Eel) releases. Use the Product and Version selectors above to view content specific to a different software release.
\ No newline at end of file
diff --git a/layouts/shortcodes/header.html b/layouts/shortcodes/header.html
index 205c717b3b..4d9192d14c 100644
--- a/layouts/shortcodes/header.html
+++ b/layouts/shortcodes/header.html
@@ -1,6 +1,6 @@
-
+
{{ .Get "version" }}
-
+
+
{{- range $index, $majorVersion := .majorVersions }}
{{ $majorVersion.lifecycle }}
{{- end }}
@@ -21,35 +21,74 @@
{{- range $index, $majorVersion := .majorVersions }}
-
{{ $majorVersion.majorVersion }}
+ {{- if eq $majorVersion.lifecycle "Archive" }}
+ {{- range $majorVersion.majorVersions }}
+
+ {{ .majorVersion }}
+
- {{- range $majorVersion.releases }}
-
- {{- if and (.link) (.name) }}
- {{ .name }}
- {{- else }}
- {{ .name }}
- {{- end }}
+ {{- range .releases }}
+
+ {{- if and (.link) (.name) }}
+ {{ .name }}
+ {{- else }}
+ {{ .name }}
+ {{- end }}
- {{- with .type }}
- {{ . }}
- {{- end }}
+ {{- with .type }}
+ {{ . }}
+ {{- end }}
- {{- if .date }}
- {{ if eq .date "" }}TBD{{ else }}{{ dateFormat "2 January 2006" .date }}{{ end }}
- {{- end }}
-
-
-
- {{- with .description }}
- {{- $desc := . }}
- {{- if reflect.IsMap $desc }}
- {{- $desc = (index $desc $.Site.Language.Lang) }}
+ {{- if .date }}
+
{{ if eq .date "" }}TBD{{ else }}{{ dateFormat "2 January 2006" .date }}{{ end }}
{{- end }}
- {{ $desc | $.Page.RenderString }}
+
+
+
+ {{- with .description }}
+ {{- $desc := . }}
+ {{- if reflect.IsMap $desc }}
+ {{- $desc = (index $desc $.Site.Language.Lang) }}
+ {{- end }}
+ {{ $desc | $.Page.RenderString }}
+ {{- end }}
+
+
+ {{- end }}
+ {{- end }}
+ {{- else }}
+
+ {{ .majorVersion }}
+
+
+ {{- range $majorVersion.releases }}
+
+ {{- if and (.link) (.name) }}
+ {{ .name }}
+ {{- else }}
+ {{ .name }}
{{- end }}
-
+
+ {{- with .type }}
+
{{ . }}
+ {{- end }}
+
+ {{- if .date }}
+
{{ if eq .date "" }}TBD{{ else }}{{ dateFormat "2 January 2006" .date }}{{ end }}
+ {{- end }}
+
+
+
+ {{- with .description }}
+ {{- $desc := . }}
+ {{- if reflect.IsMap $desc }}
+ {{- $desc = (index $desc $.Site.Language.Lang) }}
+ {{- end }}
+ {{ $desc | $.Page.RenderString }}
+ {{- end }}
+
+
+ {{- end }}
{{- end }}
{{- end }}
diff --git a/static/api/scale_rest_api.html b/static/api/scale_rest_api.html
index 0879eef7a5..d41f7a824c 100644
--- a/static/api/scale_rest_api.html
+++ b/static/api/scale_rest_api.html
@@ -12,7 +12,7 @@
diff --git a/static/api/scale_websocket_api.html b/static/api/scale_websocket_api.html
index 2e62c6f44d..c336a0b62b 100644
--- a/static/api/scale_websocket_api.html
+++ b/static/api/scale_websocket_api.html
@@ -7219,7 +7219,8 @@
app
"CRASHED",
"DEPLOYING",
"RUNNING",
- "STOPPED"
+ "STOPPED",
+ "STOPPING"
]
},
"upgrade_available": {
@@ -7625,7 +7626,8 @@
app
"CRASHED",
"DEPLOYING",
"RUNNING",
- "STOPPED"
+ "STOPPED",
+ "STOPPING"
]
},
"upgrade_available": {
@@ -8174,7 +8176,8 @@
app
"CRASHED",
"DEPLOYING",
"RUNNING",
- "STOPPED"
+ "STOPPED",
+ "STOPPING"
]
},
"upgrade_available": {
@@ -9454,7 +9457,8 @@
app
"CRASHED",
"DEPLOYING",
"RUNNING",
- "STOPPED"
+ "STOPPED",
+ "STOPPING"
]
},
"upgrade_available": {
@@ -9742,7 +9746,8 @@
app
"CRASHED",
"DEPLOYING",
"RUNNING",
- "STOPPED"
+ "STOPPED",
+ "STOPPING"
]
},
"upgrade_available": {
@@ -10034,7 +10039,8 @@
app
"CRASHED",
"DEPLOYING",
"RUNNING",
- "STOPPED"
+ "STOPPED",
+ "STOPPING"
]
},
"upgrade_available": {
@@ -10438,7 +10444,8 @@
app
"CRASHED",
"DEPLOYING",
"RUNNING",
- "STOPPED"
+ "STOPPED",
+ "STOPPING"
]
},
"upgrade_available": {
@@ -11203,7 +11210,8 @@
app
"CRASHED",
"DEPLOYING",
"RUNNING",
- "STOPPED"
+ "STOPPED",
+ "STOPPING"
]
},
"upgrade_available": {
@@ -11566,7 +11574,8 @@
app
"CRASHED",
"DEPLOYING",
"RUNNING",
- "STOPPED"
+ "STOPPED",
+ "STOPPING"
]
},
"upgrade_available": {
@@ -36001,6 +36010,29 @@
core
"title": "result",
"_required_": false
},
+ "result_encoding_error": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "integer"
+ },
+ {
+ "type": "boolean"
+ },
+ {
+ "type": "object"
+ },
+ {
+ "type": "array"
+ }
+ ],
+ "nullable": true,
+ "_name_": "result_encoding_error",
+ "title": "result_encoding_error",
+ "_required_": false
+ },
"error": {
"_name_": "error",
"title": "error",
@@ -36156,6 +36188,7 @@
core
"logs_excerpt",
"progress",
"result",
+ "result_encoding_error",
"error",
"exception",
"exc_info",
@@ -36313,6 +36346,29 @@
core
"title": "result",
"_required_": false
},
+ "result_encoding_error": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "integer"
+ },
+ {
+ "type": "boolean"
+ },
+ {
+ "type": "object"
+ },
+ {
+ "type": "array"
+ }
+ ],
+ "nullable": true,
+ "_name_": "result_encoding_error",
+ "title": "result_encoding_error",
+ "_required_": false
+ },
"error": {
"_name_": "error",
"title": "error",
@@ -36468,6 +36524,7 @@
core
"logs_excerpt",
"progress",
"result",
+ "result_encoding_error",
"error",
"exception",
"exc_info",
@@ -38772,9 +38829,18 @@
device
"_name_": "uses_system_critical_devices",
"title": "uses_system_critical_devices",
"_required_": true
+ },
+ "critical_reason": {
+ "_name_": "critical_reason",
+ "title": "critical_reason",
+ "_required_": true,
+ "type": [
+ "string",
+ "null"
+ ]
}
},
- "additionalProperties": false,
+ "additionalProperties": true,
"_name_": "gpu_info",
"title": "gpu_info",
"default": {},
@@ -38785,7 +38851,8 @@
device
"devices",
"vendor",
"available_to_host",
- "uses_system_critical_devices"
+ "uses_system_critical_devices",
+ "critical_reason"
]
}
]
@@ -89680,28 +89747,6 @@
pool.dataset
"APPS"
]
},
- "xattr": {
- "_name_": "xattr",
- "title": "xattr",
- "default": "SA",
- "_required_": false,
- "enum": [
- "ON",
- "SA"
- ],
- "nullable": false,
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "string",
- "enum": [
- "INHERIT"
- ]
- }
- ]
- },
"encryption_options": {
"type": "object",
"properties": {
@@ -89865,7 +89910,6 @@
pool.dataset
"aclmode",
"acltype",
"share_type",
- "xattr",
"encryption_options",
"encryption",
"inherit_encryption",
@@ -111761,28 +111805,6 @@
pool.dataset
}
]
},
- "xattr": {
- "_name_": "xattr",
- "title": "xattr",
- "default": "SA",
- "_required_": false,
- "enum": [
- "ON",
- "SA"
- ],
- "nullable": false,
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "string",
- "enum": [
- "INHERIT"
- ]
- }
- ]
- },
"user_properties": {
"_name_": "user_properties",
"title": "user_properties",
@@ -111900,7 +111922,6 @@
pool.dataset
"recordsize",
"aclmode",
"acltype",
- "xattr",
"user_properties",
"create_ancestors",
"user_properties_update"
@@ -138536,7 +138557,7 @@
smart.test
|
- Query S.M.A.R.T. tests for the specified disk.
+ Query S.M.A.R.T. tests for the specified disk name.
|
@@ -167212,7 +167233,8 @@
Return Arguments
"CRASHED",
"DEPLOYING",
"RUNNING",
-
"STOPPED"
+
"STOPPED",
+
"STOPPING"
]
},
"upgrade_available": {
@@ -178785,102 +178807,6 @@
Return Arguments
]
-
failover.setup
-
Sent when failover is being setup.
-
This event can be subscribed to with the wildcard * as the event name.
-
Return Arguments
-
[
- {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "integer"
- },
- {
- "type": "boolean"
- },
- {
- "type": "object"
- },
- {
- "type": "array"
- }
- ],
- "nullable": true,
- "_name_": "failover.setup",
- "title": "failover.setup",
- "_required_": false
- }
- ]
-
-
-
failover.status
-
Sent when failover status changes.
-
This event can be subscribed to with the wildcard * as the event name.
-
Return Arguments
-
[
- {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "integer"
- },
- {
- "type": "boolean"
- },
- {
- "type": "object"
- },
- {
- "type": "array"
- }
- ],
- "nullable": true,
- "_name_": "failover.status",
- "title": "failover.status",
- "_required_": false
- }
- ]
-
-
-
failover.upgrade_pending
-
Sent when system is ready and HA upgrade is pending.
-
It is expected the client will react by issuing upgrade_finish call
-at user will.
-
-
This event can be subscribed to with the wildcard * as the event name.
-
Return Arguments
-
[
- {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "integer"
- },
- {
- "type": "boolean"
- },
- {
- "type": "object"
- },
- {
- "type": "array"
- }
- ],
- "nullable": true,
- "_name_": "failover.upgrade_pending",
- "title": "failover.upgrade_pending",
- "_required_": false
- }
- ]
-
-
directoryservices.status
Sent on directory service state changes.
This event can be subscribed to with the wildcard * as the event name.
@@ -178912,8 +178838,8 @@
Return Arguments
]
docker.state
-Docker state events
+failover.setup
+Sent when failover is being setup.
This event can be subscribed to with the wildcard * as the event name.
Return Arguments
[
@@ -178936,15 +178862,15 @@ Return Arguments
}
],
"nullable": true,
- "_name_": "docker.state",
- "title": "docker.state",
+ "_name_": "failover.setup",
+ "title": "failover.setup",
"_required_": false
}
]
docker.events
-Docker container events
+failover.status
+Sent when failover status changes.
This event can be subscribed to with the wildcard * as the event name.
Return Arguments
[
@@ -178967,15 +178893,18 @@ Return Arguments
}
],
"nullable": true,
- "_name_": "docker.events",
- "title": "docker.events",
+ "_name_": "failover.status",
+ "title": "failover.status",
"_required_": false
}
]
truecommand.config
-Sent on TrueCommand configuration changes.
+failover.upgrade_pending
+Sent when system is ready and HA upgrade is pending.
+It is expected the client will react by issuing upgrade_finish call
+at user will.
+
This event can be subscribed to with the wildcard * as the event name.
Return Arguments
[
@@ -178998,15 +178927,15 @@ Return Arguments
}
],
"nullable": true,
- "_name_": "truecommand.config",
- "title": "truecommand.config",
+ "_name_": "failover.upgrade_pending",
+ "title": "failover.upgrade_pending",
"_required_": false
}
]
disk.query
-Sent on disk changes.
+user.web_ui_login_disabled
+Sent when root user login to the Web UI is disabled.
This event can be subscribed to with the wildcard * as the event name.
Return Arguments
[
@@ -179029,8 +178958,8 @@ Return Arguments
}
],
"nullable": true,
- "_name_": "disk.query",
- "title": "disk.query",
+ "_name_": "user.web_ui_login_disabled",
+ "title": "user.web_ui_login_disabled",
"_required_": false
}
]
@@ -179098,8 +179027,8 @@ Return Arguments
]
zfs.pool.scan
-Progress of pool resilver/scrub.
+docker.events
+Docker container events
This event can be subscribed to with the wildcard * as the event name.
Return Arguments
[
@@ -179122,15 +179051,15 @@ Return Arguments
}
],
"nullable": true,
- "_name_": "zfs.pool.scan",
- "title": "zfs.pool.scan",
+ "_name_": "docker.events",
+ "title": "docker.events",
"_required_": false
}
]
user.web_ui_login_disabled
-Sent when root user login to the Web UI is disabled.
+docker.state
+Docker state events
This event can be subscribed to with the wildcard * as the event name.
Return Arguments
[
@@ -179153,21 +179082,17 @@ Return Arguments
}
],
"nullable": true,
- "_name_": "user.web_ui_login_disabled",
- "title": "user.web_ui_login_disabled",
+ "_name_": "docker.state",
+ "title": "docker.state",
"_required_": false
}
]
filesystem.file_tail_follow
-Retrieve last no_of_lines specified as an integer argument for a specific path and then
-
any new lines as they are added. Specified argument has the format path:no_of_lines ( /var/log/messages:3 ).
-no_of_lines is optional and if it is not specified it defaults to 3.
-However, path is required for this.
-
-This event cannot be subscribed to with the wildcard * as the event name.
-Accept Arguments
+disk.query
+Sent on disk changes.
+This event can be subscribed to with the wildcard * as the event name.
+Return Arguments
[
{
"anyOf": [
@@ -179188,7 +179113,104 @@ Accept Arguments
}
],
"nullable": true,
- "_name_": "filefollowtaileventsource",
+ "_name_": "disk.query",
+ "title": "disk.query",
+ "_required_": false
+ }
+ ]
+
zfs.pool.scan
+Progress of pool resilver/scrub.
+This event can be subscribed to with the wildcard * as the event name.
+Return Arguments
+ [
+ {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "integer"
+ },
+ {
+ "type": "boolean"
+ },
+ {
+ "type": "object"
+ },
+ {
+ "type": "array"
+ }
+ ],
+ "nullable": true,
+ "_name_": "zfs.pool.scan",
+ "title": "zfs.pool.scan",
+ "_required_": false
+ }
+ ]
+
truecommand.config
+Sent on TrueCommand configuration changes.
+This event can be subscribed to with the wildcard * as the event name.
+Return Arguments
+ [
+ {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "integer"
+ },
+ {
+ "type": "boolean"
+ },
+ {
+ "type": "object"
+ },
+ {
+ "type": "array"
+ }
+ ],
+ "nullable": true,
+ "_name_": "truecommand.config",
+ "title": "truecommand.config",
+ "_required_": false
+ }
+ ]
+
filesystem.file_tail_follow
+Retrieve last no_of_lines specified as an integer argument for a specific path and then
+
any new lines as they are added. Specified argument has the format path:no_of_lines ( /var/log/messages:3 ).
+no_of_lines is optional and if it is not specified it defaults to 3.
+However, path is required for this.
+
+This event cannot be subscribed to with the wildcard * as the event name.
+Accept Arguments
+ [
+ {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "integer"
+ },
+ {
+ "type": "boolean"
+ },
+ {
+ "type": "object"
+ },
+ {
+ "type": "array"
+ }
+ ],
+ "nullable": true,
+ "_name_": "filefollowtaileventsource",
"_required_": false
}
]
@@ -179221,6 +179243,240 @@ Return Arguments
]
app.stats
+Retrieve statistics of apps.
+This event cannot be subscribed to with the wildcard * as the event name.
+Accept Arguments
+ [
+ {
+ "type": "object",
+ "properties": {
+ "interval": {
+ "type": "integer",
+ "_name_": "interval",
+ "title": "interval",
+ "default": 2,
+ "_required_": false
+ }
+ },
+ "additionalProperties": false,
+ "_name_": "appstatseventsource",
+ "default": {},
+ "_required_": false,
+ "_attrs_order_": [
+ "interval"
+ ]
+ }
+ ]
+
Return Arguments
+ [
+ {
+ "_name_": "apps_stats",
+ "title": "apps_stats",
+ "default": [],
+ "_required_": false,
+ "type": "array",
+ "items": [
+ {
+ "type": "object",
+ "properties": {
+ "app_name": {
+ "_name_": "app_name",
+ "title": "app_name",
+ "_required_": false,
+ "type": "string"
+ },
+ "cpu_usage": {
+ "type": "integer",
+ "_name_": "cpu_usage",
+ "title": "cpu_usage",
+ "description": "Percentage of cpu used by an app",
+ "_required_": false
+ },
+ "memory": {
+ "type": "integer",
+ "_name_": "memory",
+ "title": "memory",
+ "description": "Current memory(in bytes) used by an app",
+ "_required_": false
+ },
+ "networks": {
+ "_name_": "networks",
+ "title": "networks",
+ "default": [],
+ "_required_": false,
+ "type": "array",
+ "items": [
+ {
+ "type": "object",
+ "properties": {
+ "interface_name": {
+ "_name_": "interface_name",
+ "title": "interface_name",
+ "description": "Name of the interface use by the app",
+ "_required_": false,
+ "type": "string"
+ },
+ "rx_bytes": {
+ "type": "integer",
+ "_name_": "rx_bytes",
+ "title": "rx_bytes",
+ "description": "Received bytes/s by an interface",
+ "_required_": false
+ },
+ "tx_bytes": {
+ "type": "integer",
+ "_name_": "tx_bytes",
+ "title": "tx_bytes",
+ "description": "Transmitted bytes/s by an interface",
+ "_required_": false
+ }
+ },
+ "additionalProperties": false,
+ "_name_": "interface_stats",
+ "title": "interface_stats",
+ "default": {},
+ "_required_": false,
+ "_attrs_order_": [
+ "interface_name",
+ "rx_bytes",
+ "tx_bytes"
+ ]
+ }
+ ]
+ },
+ "blkio": {
+ "type": "object",
+ "properties": {
+ "read": {
+ "type": "integer",
+ "_name_": "read",
+ "title": "read",
+ "description": "Blkio read bytes",
+ "_required_": false
+ },
+ "write": {
+ "type": "integer",
+ "_name_": "write",
+ "title": "write",
+ "description": "Blkio write bytes",
+ "_required_": false
+ }
+ },
+ "additionalProperties": false,
+ "_name_": "blkio",
+ "title": "blkio",
+ "default": {},
+ "_required_": false,
+ "_attrs_order_": [
+ "read",
+ "write"
+ ]
+ }
+ },
+ "additionalProperties": false,
+ "_name_": "stats",
+ "title": "stats",
+ "default": {},
+ "_required_": false,
+ "_attrs_order_": [
+ "app_name",
+ "cpu_usage",
+ "memory",
+ "networks",
+ "blkio"
+ ]
+ }
+ ]
+ }
+ ]
+
app.container_log_follow
+Retrieve logs of a container/service in an app.
+Name of app and id of container/service is required.
+Optionally tail_lines and limit_bytes can be specified.
+tail_lines is an option to select how many lines of logs to retrieve for the said container. It
+defaults to 500. If set to null, it will retrieve complete logs of the container.
+
+This event cannot be subscribed to with the wildcard * as the event name.
+Accept Arguments
+ [
+ {
+ "type": "object",
+ "properties": {
+ "tail_lines": {
+ "type": [
+ "integer",
+ "null"
+ ],
+ "_name_": "tail_lines",
+ "title": "tail_lines",
+ "default": 500,
+ "_required_": false,
+ "description": "Optionally `tail_lines` and `limit_bytes` can be specified."
+ },
+ "app_name": {
+ "_name_": "app_name",
+ "title": "app_name",
+ "_required_": true,
+ "type": "string"
+ },
+ "container_id": {
+ "_name_": "container_id",
+ "title": "container_id",
+ "_required_": true,
+ "type": "string"
+ }
+ },
+ "additionalProperties": false,
+ "_name_": "appcontainerlogsfollowtaileventsource",
+ "default": {},
+ "_required_": false,
+ "_attrs_order_": [
+ "tail_lines",
+ "app_name",
+ "container_id"
+ ]
+ }
+ ]
+
Return Arguments
+ [
+ {
+ "type": "object",
+ "properties": {
+ "data": {
+ "_name_": "data",
+ "title": "data",
+ "_required_": true,
+ "type": "string"
+ },
+ "timestamp": {
+ "_name_": "timestamp",
+ "title": "timestamp",
+ "_required_": true,
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "additionalProperties": false,
+ "_name_": "appcontainerlogsfollowtaileventsource_returns",
+ "default": {},
+ "_required_": false,
+ "_attrs_order_": [
+ "data",
+ "timestamp"
+ ]
+ }
+ ]
+
smart.test.progress
Reports current S.M.A.R.T. test progress for the specified disk.
This event cannot be subscribed to with the wildcard * as the event name.
@@ -179643,242 +179899,6 @@ Return Arguments
]
-app.stats
-Retrieve statistics of apps.
-This event cannot be subscribed to with the wildcard * as the event name.
-Accept Arguments
- [
- {
- "type": "object",
- "properties": {
- "interval": {
- "type": "integer",
- "_name_": "interval",
- "title": "interval",
- "default": 2,
- "_required_": false
- }
- },
- "additionalProperties": false,
- "_name_": "appstatseventsource",
- "default": {
- "interval": 2
- },
- "_required_": false,
- "_attrs_order_": [
- "interval"
- ]
- }
- ]
-
Return Arguments
- [
- {
- "_name_": "apps_stats",
- "title": "apps_stats",
- "default": [],
- "_required_": false,
- "type": "array",
- "items": [
- {
- "type": "object",
- "properties": {
- "app_name": {
- "_name_": "app_name",
- "title": "app_name",
- "_required_": false,
- "type": "string"
- },
- "cpu_usage": {
- "type": "integer",
- "_name_": "cpu_usage",
- "title": "cpu_usage",
- "description": "Percentage of cpu used by an app",
- "_required_": false
- },
- "memory": {
- "type": "integer",
- "_name_": "memory",
- "title": "memory",
- "description": "Current memory(in bytes) used by an app",
- "_required_": false
- },
- "networks": {
- "_name_": "networks",
- "title": "networks",
- "default": [],
- "_required_": false,
- "type": "array",
- "items": [
- {
- "type": "object",
- "properties": {
- "interface_name": {
- "_name_": "interface_name",
- "title": "interface_name",
- "description": "Name of the interface use by the app",
- "_required_": false,
- "type": "string"
- },
- "rx_bytes": {
- "type": "integer",
- "_name_": "rx_bytes",
- "title": "rx_bytes",
- "description": "Received bytes/s by an interface",
- "_required_": false
- },
- "tx_bytes": {
- "type": "integer",
- "_name_": "tx_bytes",
- "title": "tx_bytes",
- "description": "Transmitted bytes/s by an interface",
- "_required_": false
- }
- },
- "additionalProperties": false,
- "_name_": "interface_stats",
- "title": "interface_stats",
- "default": {},
- "_required_": false,
- "_attrs_order_": [
- "interface_name",
- "rx_bytes",
- "tx_bytes"
- ]
- }
- ]
- },
- "blkio": {
- "type": "object",
- "properties": {
- "read": {
- "type": "integer",
- "_name_": "read",
- "title": "read",
- "description": "Blkio read bytes",
- "_required_": false
- },
- "write": {
- "type": "integer",
- "_name_": "write",
- "title": "write",
- "description": "Blkio write bytes",
- "_required_": false
- }
- },
- "additionalProperties": false,
- "_name_": "blkio",
- "title": "blkio",
- "default": {},
- "_required_": false,
- "_attrs_order_": [
- "read",
- "write"
- ]
- }
- },
- "additionalProperties": false,
- "_name_": "stats",
- "title": "stats",
- "default": {},
- "_required_": false,
- "_attrs_order_": [
- "app_name",
- "cpu_usage",
- "memory",
- "networks",
- "blkio"
- ]
- }
- ]
- }
- ]
-
app.container_log_follow
-Retrieve logs of a container/service in an app.
-Name of app and id of container/service is required.
-Optionally tail_lines and limit_bytes can be specified.
-tail_lines is an option to select how many lines of logs to retrieve for the said container. It
-defaults to 500. If set to null, it will retrieve complete logs of the container.
-
-This event cannot be subscribed to with the wildcard * as the event name.
-Accept Arguments
- [
- {
- "type": "object",
- "properties": {
- "tail_lines": {
- "type": [
- "integer",
- "null"
- ],
- "_name_": "tail_lines",
- "title": "tail_lines",
- "default": 500,
- "_required_": false,
- "description": "Optionally `tail_lines` and `limit_bytes` can be specified."
- },
- "app_name": {
- "_name_": "app_name",
- "title": "app_name",
- "_required_": true,
- "type": "string"
- },
- "container_id": {
- "_name_": "container_id",
- "title": "container_id",
- "_required_": true,
- "type": "string"
- }
- },
- "additionalProperties": false,
- "_name_": "appcontainerlogsfollowtaileventsource",
- "default": {},
- "_required_": false,
- "_attrs_order_": [
- "tail_lines",
- "app_name",
- "container_id"
- ]
- }
- ]
-
Return Arguments
- [
- {
- "type": "object",
- "properties": {
- "data": {
- "_name_": "data",
- "title": "data",
- "_required_": true,
- "type": "string"
- },
- "timestamp": {
- "_name_": "timestamp",
- "title": "timestamp",
- "_required_": true,
- "type": [
- "string",
- "null"
- ]
- }
- },
- "additionalProperties": false,
- "_name_": "appcontainerlogsfollowtaileventsource_returns",
- "default": {},
- "_required_": false,
- "_attrs_order_": [
- "data",
- "timestamp"
- ]
- }
- ]
-
Subscribing to Events
Events are generated by the system based on when certain conditions are met. It is not useful
if the system is generating an event and there is no event listener. Listening to events
diff --git a/static/images/SCALE_Electric_Eel_Icon.png b/static/images/SCALE_Electric_Eel_Icon.png
new file mode 100644
index 0000000000..0f46adb535
Binary files /dev/null and b/static/images/SCALE_Electric_Eel_Icon.png differ
diff --git a/static/includes/24.10FeatureList.md b/static/includes/24.10FeatureList.md
index 05e71fea37..d43d4e972e 100644
--- a/static/includes/24.10FeatureList.md
+++ b/static/includes/24.10FeatureList.md
@@ -1,21 +1,21 @@
-24.10 (Electric Eel) brings many new features and improvements to the TrueNAS SCALE experience:
+24.10 (Electric Eel) brings many new features and improvements to the TrueNAS experience:
{{< columns >}}
-* The [TrueNAS Apps](https://www.truenas.com/docs/truenasapps/) feature backend moves from Kubernetes to Docker to streamline App deployment and management ([announcement](https://forums.truenas.com/t/the-future-of-electric-eel-and-apps/5409)). **Custom App** deployment is being reworked with Docker Compose integration.
+* The [TrueNAS Apps](https://www.truenas.com/docs/truenasapps/) feature backend moves from Kubernetes to Docker to streamline App deployment and management ([announcement](https://forums.truenas.com/t/the-future-of-electric-eel-and-apps/5409)). [Custom App](https://www.truenas.com/docs/truenasapps/usingcustomapp/) deployment of Docker images is available via a guided wizard or a Compose YAML file.
* [Extend a RAIDZ vdev]({{< relref "ManagePoolsScale.md #extending-a-raidz-vdev" >}}) with individual disks (OpenZFS feature sponsored by iXsystems).
* New [TrueCloud Backup Tasks]({{< relref "TrueCloudTasks.md" >}}) with streamlined functionality for Storj iX cloud backups and restoration.
-* New [global search]({{< relref "GlobalSearch.md" >}}) for finding pages and settings in the SCALE UI.
+* New [global search]({{< relref "GlobalSearch.md" >}}) for finding pages and settings in the TrueNAS UI.
* [Dashboard]({{< relref "/scaletutorials/dashboard/_index.md" >}}) reworked with more widgets, data reporting, and customization.
* UI support for NVMe [S.M.A.R.T. tests]({{< relref "SMARTTestsSCALE.md" >}}).
-* [Align Enclosure Management]({{< relref "enclosurescreensscale.md" >}}) code with CORE and improve the feature's performance.
+* [Align Enclosure Management]({{< relref "enclosurescreensscale.md" >}}) code with 13.3 and improve feature performance.
<--->
@@ -27,7 +27,7 @@
* Replace nslcd with sssd to improve Kerberos, NFS, and SMB support in non-AD environments ([NAS-127073](https://ixsystems.atlassian.net/browse/NAS-127073)).
-* Generate a unique system ID for each SCALE install ([NAS-123519](https://ixsystems.atlassian.net/browse/NAS-123519)).
+* Generate a unique system ID for each install ([NAS-123519](https://ixsystems.atlassian.net/browse/NAS-123519)).
* ZFS Fast Deduplication (OpenZFS feature sponsored by iXsystems): This feature is partially present in TrueNAS, but is considered experimental and disabled by default in 24.10. Full UI integration is anticipated in a future TrueNAS release ([NAS-127088](https://ixsystems.atlassian.net/browse/NAS-127088)).
diff --git a/static/includes/24.10UpgradeMethods.md b/static/includes/24.10UpgradeMethods.md
index b0a7cd398c..74162dc3a9 100644
--- a/static/includes/24.10UpgradeMethods.md
+++ b/static/includes/24.10UpgradeMethods.md
@@ -1,4 +1,4 @@
-With a stable release, upgrading to SCALE 24.10 (Electric Eel) from an earlier SCALE release is primarily done using the web interface [update process]({{< relref "UpdateSCALE.md" >}}).
-Another upgrade option is to use a SCALE **.iso** file to perform a [fresh install]({{< relref "/GettingStarted/Install/_index.md" >}}) on the system and then restore a [system configuration file]({{< relref "ManageSysConfigSCALE.md" >}}).
+With a stable release, upgrading to TrueNAS 24.10 (Electric Eel) from an earlier release is primarily done using the web interface [update process]({{< relref "UpdateSCALE.md" >}}).
+Another upgrade option is to use an **.iso** file to perform a [fresh install]({{< relref "/GettingStarted/Install/_index.md" >}}) on the system and then restore a [system configuration file]({{< relref "ManageSysConfigSCALE.md" >}}).
diff --git a/static/includes/NetworkWarn.md b/static/includes/NetworkWarn.md
new file mode 100644
index 0000000000..7d7f85d6ed
--- /dev/null
+++ b/static/includes/NetworkWarn.md
@@ -0,0 +1,9 @@
+
+
+{{< hint type=warning title="Disruptive Change" >}}
+You can lose your TrueNAS connection if you change the network interface that the web interface uses!
+You might need command line knowledge or physical access to the TrueNAS system to fix misconfigured network settings.
+
+Do not configure network settings to depend on any client container or application hosted on the TrueNAS system, such as DNS services, proxy networks, firewalls, and routers.
+This is an unsupported configuration because TrueNAS cannot access the necessary networks during boot if the client container has not started.
+{{< /hint >}}
diff --git a/static/includes/SCALEUpgradePaths.md b/static/includes/SCALEUpgradePaths.md
index 3cdc2b30af..3056a92b70 100644
--- a/static/includes/SCALEUpgradePaths.md
+++ b/static/includes/SCALEUpgradePaths.md
@@ -52,7 +52,7 @@
B["CORE 13.0-U6.2
CORE 13.3-RELEASE"] -->|ISO install| E
C["22.12.4.2 (Bluefin)"] -->|update| D
D["23.10.2 (Cobia)"] -->|update| E
- E["24.04.2.2 (Dragonfish)"] -->|anticipated| H
+ E["24.04.2.3 (Dragonfish)"] -->|update| H
H["24.10.0 (Electric Eel)"]
{{< /mermaid >}}
@@ -67,7 +67,7 @@
A["CORE 13.0-U6.2"] -->|ISO install| D
B["Current 23.10 (Cobia) release"] -->|update| C
C["23.10.2 (Cobia)"] -->|update| D
- D["24.04.2.2 (Dragonfish)"] -->|anticipated| E
+ D["24.04.2.3 (Dragonfish)"] -->|update| E
E["24.10.0 (Electric Eel)"]
{{< /mermaid >}}
diff --git a/words-to-ignore.txt b/words-to-ignore.txt
index dda5835b3a..9168b52d4a 100644
--- a/words-to-ignore.txt
+++ b/words-to-ignore.txt
@@ -2057,5 +2057,7 @@ AppsInstallWizardSettings
UsingCustomApp
ixVolumes
RESTAPIDeprecationNotice
+tn-openstorage-logo
+Tailscale
CMD
InstallAppResourceConfigurationGPU