Skip to content

docs: document the minimum Talos version that can connect to Omni - #927

Open
oguzkilcan wants to merge 1 commit into
siderolabs:mainfrom
oguzkilcan:docs/omni-talos-version-floor
Open

oguzkilcan wants to merge 1 commit into
siderolabs:mainfrom
oguzkilcan:docs/omni-talos-version-floor

Conversation

@oguzkilcan

Copy link
Copy Markdown
Member

The support policy said Omni v1.11.0 would refuse to start with machines below the minimum supported Talos version. Replace it with the new model: starting with the first Omni minor release of 2027, Omni will disconnect machines running Talos below 1.6, and from then on only the last 10 Talos minors (counted from the default Talos version) will be able to connect.

The minimum version moves up only with Omni minor releases, each time with a new flag and config setting (e.g., --siderolink-disconnect-talos-below-1-6). If such machines exist and neither is set, Omni will not start.

@github-project-automation github-project-automation Bot moved this to To Do in Planning Nov 5, 2026
@talos-bot talos-bot moved this from To Do to In Review in Planning Nov 5, 2026
@github-actions

github-actions Bot commented Nov 5, 2026 •

Copy link
Copy Markdown

Superseded: a later run (commit 712dea2) completed.

@mintlify

mintlify Bot commented Nov 5, 2026 •

Copy link
Copy Markdown
Contributor

Preview approval required

This pull request comes from a fork, so Mintlify won't build a preview until someone with write access approves commit 712dea2.

Approve preview

@github-project-automation github-project-automation Bot moved this from In Review to Approved in Planning Nov 6, 2026
@oguzkilcan
oguzkilcan force-pushed the docs/omni-talos-version-floor branch from a4a63ab to 96676c6 Compare November 11, 2026 10:11
@github-actions

github-actions Bot commented Nov 11, 2026 •

Copy link
Copy Markdown

📋 Automated documentation review

An automated pass runs on documentation changes in every PR. The items below are suggestions to consider — advisory, not a merge gate.

Reviewed commit 712dea2 · 🔴 0 critical · 🟡 2 warning(s) · ⚪ 2 notice(s)

  • 🟡 public/omni/getting-started/talos-version-support-policy.mdx:28 — Missing warning that setting --siderolink-disconnect-talos-below can make a future Omni release refuse to start
    • Why: Omni's schema.json documents that when a future release raises the Talos version floor, Omni refuses to start if any machine runs a version between the configured value and the new floor. The page omits this, and it also deletes the previous revision's warning that Omni will not start below the baseline.
    • Fix: Add: this setting is a standing confirmation - when a future Omni release raises the Talos version floor, Omni will refuse to start if any machine runs a version between this value and the new floor.
  • 🟡 public/omni/getting-started/talos-version-support-policy.mdx:27 — Does not warn that disconnected machines can no longer be upgraded through Omni
    • Why: Once SideroLink is refused, a machine is unmanageable from Omni, including the Talos upgrade the next section tells readers to run through Omni; recovery needs direct talosctl access to each machine.
    • Fix: Add before the snippet: upgrade any machines running Talos below 1.6 before setting this flag, since a disconnected machine can only be upgraded with direct talosctl access.

Notices, and the reviewer's full report, are in the run's doc-accuracy-report artifact.

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 <oguz.kilcan@siderolabs.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Approved

Development

Successfully merging this pull request may close these issues.

3 participants