docs: add Talos version support policy page for Omni#494
docs: add Talos version support policy page for Omni#494oguzkilcan wants to merge 1 commit intosiderolabs:mainfrom
Conversation
![claude[bot]](https://avatars.githubusercontent.com/in/1236702?s=60&v=4){kind=small}
There was a problem hiding this comment.
Pull request overview
Adds documentation describing Omni’s Talos Linux version support expectations and links it into the existing “Support Matrix” and upgrade guidance, so users can understand minimum-version enforcement and how to remediate.
Changes:
- Add a new “Talos Version Support Policy” page under Omni > Getting Started.
- Cross-link the Support Matrix and Upgrading Clusters docs to the new policy page.
- Update navigation/docs index entries (omni.yaml and generated public/docs.json).
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| public/omni/getting-started/talos-version-support-policy.mdx | New policy page describing supported Talos requirements and enforcement behavior. |
| public/omni/getting-started/support-matrix.mdx | Adds a pointer to the new policy page for enforcement/notifications context. |
| public/omni/cluster-management/upgrading-clusters.mdx | Adds a note that supported Talos versions are required and will be enforced. |
| public/docs.json | Adds the new page to the generated docs index for navigation/search. |
| omni.yaml | Adds the new page to the “Getting Started” navigation group. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ## Overview | ||
|
|
||
| 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. |
There was a problem hiding this comment.
I'd explain what unsupported entails:
- Will they still function?
- Can they break at any point from there on?
- Will I still be able to update them, once they reached that state?
Probably some more...
There was a problem hiding this comment.
oh I see you briefly touched on that below.
What about the SaaS? How does that play out? Maybe we should also add a hint regarding professional support, not sure if this is included if a machine has reached this state.
There was a problem hiding this comment.
Same as self hosted. If Omni instance has unsupported Machines, it won't start. We are usually handling updating the MinTalosVersion constant on minor Omni releases, so you won't be able to run next Omni version, unless all the machines have been updated.
There was a problem hiding this comment.
How does a customer update a talos machine under omni control, if the omni instance is not running?
I wouldn't even know how to do that.
|
|
||
| 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 displays warning notifications for machines running unsupported or soon-to-be-unsupported Talos versions, and will enforce minimum version requirements in a future release. See the [Talos Version Support Policy](./talos-version-support-policy) for details on enforcement timelines and notification zones. |
There was a problem hiding this comment.
| Omni displays warning notifications for machines running unsupported or soon-to-be-unsupported Talos versions, and will enforce minimum version requirements in a future release. See the [Talos Version Support Policy](./talos-version-support-policy) for details on enforcement timelines and notification zones. | |
| 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] for details on support timelines and notification windows. |
|
|
||
| For the current minimum supported Talos Linux version and the general support window, see the [Support Matrix](./support-matrix). | ||
|
|
||
| ## End-of-support enforcement |
There was a problem hiding this comment.
I think using the word "enforcement" is too strong.
| ## End-of-support enforcement | |
| ## Talos Version Compatibility | |
| 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. |
oguzkilcan
force-pushed
the
docs/talos-version-support-policy
branch
from
a178230 to
52bfd55
Compare
Adds a new page documenting Omni's Talos Linux version support policy. Signed-off-by: Oguz Kilcan <oguz.kilcan@siderolabs.com>
oguzkilcan
force-pushed
the
docs/talos-version-support-policy
branch
from
52bfd55 to
55a466e
Compare
|
This PR should be merged with Omni v1.8. |
Adds a new page documenting Omni's Talos Linux version support policy.