From 712dea28f8d09dacc1ae56cfa52d6da4a81c1ce9 Mon Sep 17 00:00:00 2001 From: Oguz Kilcan Date: Thu, 5 Nov 2026 15:12:42 +0100 Subject: [PATCH] docs: document the minimum Talos version that can connect to Omni Update the Talos version support policy with the Talos versions that will be incompatible with Omni starting with its first minor release of 2027. Also add the minimum Talos version to connect to the support matrix. Signed-off-by: Oguz Kilcan --- .../omni/getting-started/support-matrix.mdx | 8 ++++- .../talos-version-support-policy.mdx | 33 ++++++++++++++++--- 2 files changed, 36 insertions(+), 5 deletions(-) diff --git a/public/omni/getting-started/support-matrix.mdx b/public/omni/getting-started/support-matrix.mdx index 5ca669bd6..a585e6f79 100644 --- a/public/omni/getting-started/support-matrix.mdx +++ b/public/omni/getting-started/support-matrix.mdx @@ -19,12 +19,18 @@ Talos Linux 1.10 Note that each version of Talos Linux generally supports up to five prior versions of Kubernetes at the time it was released. See the Talos Support Matrix for details. +## Minimum Talos Linux version to connect to Omni + +Talos Linux 1.6, starting with the first Omni minor release of 2027 (estimated January 2027) + +Talos Linux versions below it will be incompatible with Omni, and machines running them will not be able to connect. See the [Talos Version Support Policy](./talos-version-support-policy#incompatible-talos-versions). + ## Effect of non-supported Talos Linux versions If you neglect to update Talos Linux to a version where the initial minor version was released within the prior 18 months, your cluster will be out of support, and you must upgrade in order to receive support. Clusters running unsupported versions of Talos Linux or Kubernetes may have limited ability to manage their clusters within Omni - clusters may not be able to have new nodes provisioned to scale up the cluster, for example. -Omni provides status notifications for machines running Talos versions approaching end-of-support. To ensure platform stability, Omni will transition to a minimum supported version model in a future release. Please refer to the [Talos Version Support Policy](./talos-version-support-policy) for details on support timelines and notification windows. +Omni provides status notifications for machines running Talos versions approaching end-of-support. Please refer to the [Talos Version Support Policy](./talos-version-support-policy) for details on support timelines and notification windows. We encourage all users to take advantage of how easy Omni makes Talos Linux and Kubernetes upgrades, to ensure they are always running the latest security and bug fixes. diff --git a/public/omni/getting-started/talos-version-support-policy.mdx b/public/omni/getting-started/talos-version-support-policy.mdx index d45869a6b..0462d3bb1 100644 --- a/public/omni/getting-started/talos-version-support-policy.mdx +++ b/public/omni/getting-started/talos-version-support-policy.mdx @@ -4,15 +4,40 @@ description: Omni support policy for Talos Linux versions, end-of-support timeli --- Omni requires machines to run a supported version of Talos Linux. -Versions that fall below the minimum supported version are considered **unsupported** and must be upgraded. +Versions below the minimum supported version are considered **unsupported** and must be upgraded. For the current minimum supported Talos Linux version and the general support window, see the [Support Matrix](./support-matrix). -## Talos Version Compatibility +## Unsupported Talos versions -Starting with **Omni v1.11.0** (estimated **October 2026**), Omni requires all registered machines to meet the minimum supported Talos Linux version. To ensure system stability and feature compatibility, Omni will not start if any registered machines are running versions below this baseline. +Machines running unsupported versions stay connected to Omni, but Omni does not guarantee that it can manage them. +Omni shows warning notifications for machines running unsupported or soon-to-be-unsupported versions. -Until then, Omni will display warning notifications for machines running unsupported or soon-to-be-unsupported versions. +## Incompatible Talos versions + +Starting with the first Omni minor release of 2027 (estimated January 2027), Talos Linux versions below 1.6 will be **incompatible** with Omni: + +- Omni will reject their SideroLink connection requests. +- Omni will disconnect them if they are already connected. + +Until then, Omni shows a notification for these machines that cannot be dismissed. + +### Disconnecting incompatible machines earlier + +Omni does not disconnect any machines by default yet. +To disconnect the machines below 1.6 now, set the `--siderolink-disconnect-talos-below` flag: + +```bash +--siderolink-disconnect-talos-below=1.6.0 +``` + +or in the configuration file: + +```yaml +services: + siderolink: + disconnectTalosBelow: 1.6.0 +``` ## How to upgrade