Skip to content

DOCS-2849: Add PlatformMatrix component for compatibility page #2609

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ctauchen wants to merge 3 commits into
base: main
Choose a base branch
from
Open

DOCS-2849: Add PlatformMatrix component for compatibility page #2609

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
c74ccfa
DOCS-2849: Add PlatformMatrix component for compatibility page
ctauchen Mar 26, 2026
308b25c
Strip compatibility-page anchors and rework PlatformMatrix schema
ctauchen May 7, 2026
d81590c
Strip compatibility-page anchors from llms-full.txt
ctauchen May 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion calico-enterprise/_includes/components/InstallOpenshiftBeforeYouBegin.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ export default function InstallOpenshiftBeforeYouBegin(props) {
<ul>
<li>
<p>
A <Link href={`${baseUrl}/getting-started/compatibility#openshift`}>compatible OpenShift cluster</Link>
A <Link href={`${baseUrl}/getting-started/compatibility`}>compatible OpenShift cluster</Link>
</p>
<p>
Your environment meets the {prodname}{' '}
Expand Down
118 changes: 4 additions & 114 deletions calico-enterprise/getting-started/compatibility.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,133 +2,23 @@
description: Lists versions of Calico Enterprise and Kubernetes for each platform.
---

import PlatformMatrix from '@site/src/___new___/components/PlatformMatrix';

# Support and compatibility

## Supported platforms

The following list shows the platforms supported in this release. If you're working with a version older than these, consult the [documentation archive](https://docs.tigera.io/archive) or contact Support.

- [AKS](#aks)
- [EKS](#eks)
- [GKE](#gke)
- [kOps on AWS](#kops-on-aws)
- [Kubernetes-kubeadm](#kubernetes-kubeadm)
- [MKE 4k](#mke-4k)
- [MKE](#mke)
- [OpenShift](#openshift)
- [RKE](#rke)
- [RKE2](#rke2)
- [TKG](#tkg)
- [Charmed Kubernetes](#charmed-kubernetes)

### Supported $[prodname] features

If your platform is listed below, the features in this release will work for your platform unless an individual feature topic explicitly calls out a vendor or $[prodname] limitation.

Note that all Windows feature limitations are described in [Windows limitations](install-on-clusters/windows-calico/limitations.mdx), and are not called out in individual Linux topics.
Comment on lines 11 to 17
Copy link

Copilot AI Mar 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intro still says "The following list shows the platforms supported in this release", but the per-platform list/sections were removed and replaced with a multi-version matrix. This makes the section misleading (and the "Supported $[prodname] features" heading no longer introduces any actual platform-specific support details). Consider revising this text/heading to match the new matrix, or reintroduce a short summary of supported features by platform elsewhere on the page.

Copilot uses AI. Check for mistakes.

## AKS

Kubernetes version support aligns with [upstream Kubernetes](#kubernetes-kubeadm) to the latest version if available.

| $[prodname] version | $[prodname] support |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| 3.21 to current release | - $[prodname] CNI with network policy<br />- Azure CNI with $[prodname] network policy <br />- Azure CNI with $[prodname] network policy |

## EKS

Kubernetes version support aligns with [upstream Kubernetes](#kubernetes-kubeadm) to the latest version if available.

| $[prodname] version | $[prodname] support |
| ----------------------- | -------------------------------------------------------------------------------------- |
| 3.21 to current release | - $[prodname] CNI with network policy<br />- AWS CNI with $[prodname] network policy |

## GKE

Kubernetes version support aligns with [upstream Kubernetes](#kubernetes-kubeadm) to the latest version if available.

| $[prodname] version | $[prodname] support |
| ----------------------- | ------------------------------------------ |
| 3.21 to current release | - GKE CNI with $[prodname] network policy |

## kOps on AWS

| $[prodname] version | kOps and Kubernetes versions | $[prodname] support |
| -------------------- | ---------------------------- | -------------------------------------------------------------------------------------- |
| 3.23 | 1.33 - 1.34 | - $[prodname] CNI with network policy<br />- AWS CNI with $[prodname] network policy |
| 3.22 | 1.31 - 1.34 | - $[prodname] CNI with network policy<br />- AWS CNI with $[prodname] network policy |
| 3.21 | 1.31 - 1.32 | - $[prodname] CNI with network policy<br />- AWS CNI with $[prodname] network policy |
| 3.20 | 1.29 - 1.30 | - $[prodname] CNI with network policy<br />- AWS CNI with $[prodname] network policy |

## Kubernetes-kubeadm

| $[prodname] version | Kubernetes/kubeadm versions | $[prodname] support |
| -------------------- | --------------------------- | ------------------------------------ |
| 3.23 | 1.33 - 1.35 | $[prodname] CNI with network policy |
| 3.22 | 1.31 - 1.34 | $[prodname] CNI with network policy |
| 3.21 | 1.31 - 1.33 | $[prodname] CNI with network policy |
| 3.20 | 1.29 - 1.31 | $[prodname] CNI with network policy |

## MKE 4k

| $[prodname] version | MKE 4k version | $[prodname] support | Kubernetes versions |
| -------------------- | ----------- | ------------------------------------ | ------------------- |
| 3.23 | MKE 4k 4.1.2 | $[prodname] CNI with network policy | 1.32 |
| 3.22 | MKE 4k 4.1.2 | $[prodname] CNI with network policy | 1.32 |

## MKE

| $[prodname] version | MKE version | $[prodname] support | Kubernetes versions |
| -------------------- | ----------- | ------------------------------------ | ------------------- |
| 3.23 | MKE 3.9 | $[prodname] CNI with network policy | 1.34 |
| 3.22 | MKE 3.9 | $[prodname] CNI with network policy | 1.34 |
| 3.22 | MKE 3.8 | $[prodname] CNI with network policy | 1.31 |
| 3.21 | MKE 3.8 | $[prodname] CNI with network policy | 1.31 |
| 3.20 | MKE 3.8 | $[prodname] CNI with network policy | 1.31 |

## OpenShift

| $[prodname] version | OpenShift versions for Kubernetes | $[prodname] support |
| -------------------- | --------------------------------- | ------------------------------------ |
| 3.23 | 4.18 - 4.20 | $[prodname] CNI with network policy |
| 3.22 | 4.17 - 4.20 | $[prodname] CNI with network policy |
| 3.21 | 4.16 - 4.18 | $[prodname] CNI with network policy |
| 3.20 | 4.15 - 4.17 | $[prodname] CNI with network policy |

## RKE

| $[prodname] version | RKE version | $[prodname] support | Kubernetes versions |
| -------------------- | ----------- | ------------------------------------ | ------------------- |
| 3.23 | 1.8 | $[prodname] CNI with network policy | 1.32 |
| 3.22 | 1.8 | $[prodname] CNI with network policy | 1.32 |
| 3.21 | 1.8 | $[prodname] CNI with network policy | 1.32 |
| 3.20 | 1.7 | $[prodname] CNI with network policy | 1.31 |

## RKE2

| $[prodname] version | $[prodname] support | Kubernetes versions |
| -------------------- | ------------------------------------ | ------------------- |
| 3.23 | $[prodname] CNI with network policy | 1.33 - 1.34 |
| 3.22 | $[prodname] CNI with network policy | 1.31 - 1.34 |
| 3.21 | $[prodname] CNI with network policy | 1.31 - 1.33 |
| 3.20 | $[prodname] CNI with network policy | 1.29 - 1.31 |

## TKG

| $[prodname] version | TKG version | $[prodname] support | Kubernetes versions |
| -------------------- | ----------- | ------------------------------------ | ------------------- |
| 3.23 | 2.4 | $[prodname] CNI with network policy | 1.27 |
| 3.22 | 2.4 | $[prodname] CNI with network policy | 1.27 |
| 3.21 | 2.4 | $[prodname] CNI with network policy | 1.27 |
| 3.20 | 2.4 | $[prodname] CNI with network policy | 1.27 |

## Charmed Kubernetes

Kubernetes version support aligns with [upstream Kubernetes](#kubernetes-kubeadm) to the latest version if available.
## Supported Kubernetes versions by platform

| $[prodname] version | $[prodname] support |
| ----------------------- | ----------------------------------------------------------------------------------------- |
| 3.21 to current release | - $[prodname] CNI with network policy |
<PlatformMatrix />

## Supported browsers

Expand Down
2 changes: 1 addition & 1 deletion calico-enterprise/getting-started/install-on-clusters/aks.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ Install $[prodname] on an AKS managed Kubernetes cluster.

**Required**

- A [compatible AKS cluster](../compatibility.mdx#aks)
- A [compatible AKS cluster](../compatibility.mdx)

- To use the Calico CNI, you must configure the AKS cluster with [Bring your own CNI](https://docs.microsoft.com/en-us/azure/aks/use-byo-cni?tabs=azure-cli)
- To use the Azure CNI, see [Azure CNI networking](https://docs.microsoft.com/en-us/azure/aks/configure-azure-cni)
Expand Down
2 changes: 1 addition & 1 deletion calico-enterprise/getting-started/install-on-clusters/aws.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ Install $[prodname] with a self-managed Kubernetes cluster using Kubernetes Oper

**Required**

- A [compatible kOps cluster](../compatibility.mdx#kops-on-aws)
- A [compatible kOps cluster](../compatibility.mdx)
- A [Tigera license key and credentials](calico-enterprise.mdx)
- Cluster meets [system requirements](requirements.mdx)
- [Install kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/)
Expand Down
2 changes: 1 addition & 1 deletion calico-enterprise/getting-started/install-on-clusters/charmed-k8s.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ This guide describes how to install $[prodname] on a Charmed Kubernetes cluster.
**Required**

- Your cluster meets the [system requirements](requirements.mdx)
- A [compatible Charmed Kubernetes cluster](../compatibility.mdx#charmed-kubernetes)
- A [compatible Charmed Kubernetes cluster](../compatibility.mdx)
- A [compatible Charmed Kubernetes bundle](https://github.com/charmed-kubernetes/bundle/tree/main/releases) configured without a CNI
- A [Tigera license key and credentials](calico-enterprise.mdx)
- [Install kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/) on your workstation
Expand Down
2 changes: 1 addition & 1 deletion calico-enterprise/getting-started/install-on-clusters/docker-enterprise.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ The geeky details of what you get:

**Required**

- A [compatible MKE 3 cluster](../compatibility.mdx#mke) with:
- A [compatible MKE 3 cluster](../compatibility.mdx) with:

- A minimum of three nodes for non-production deployments
- CNI flag set to unmanaged, `--unmanaged-cni` so MKE 3 does not install the default $[prodname] networking plugin
Expand Down
2 changes: 1 addition & 1 deletion calico-enterprise/getting-started/install-on-clusters/eks.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ Install $[prodname] on an EKS managed Kubernetes cluster.

**Required**

* You have a [compatible EKS cluster](../compatibility.mdx#eks).
* You have a [compatible EKS cluster](../compatibility.mdx).
* Your cluster meets the [system requirements](requirements.mdx).
* You [disabled network policy for the AWS VPC CNI](https://docs.aws.amazon.com/eks/latest/userguide/network-policy-disable.html).
* You have a [Tigera license key and credentials](calico-enterprise.mdx).
Expand Down
2 changes: 1 addition & 1 deletion calico-enterprise/getting-started/install-on-clusters/gke.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ The geeky details of what you get:

**Required**

- A [compatible GKE cluster](../compatibility.mdx#gke)
- A [compatible GKE cluster](../compatibility.mdx)

- Cluster has these Networking settings:

Expand Down
2 changes: 1 addition & 1 deletion ...o-enterprise/getting-started/install-on-clusters/kubernetes/generic-install.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ The geeky details of what you get:

**Required**

- A [compatible Kubernetes cluster](../../compatibility.mdx#kubernetes-kubeadm)
- A [compatible Kubernetes cluster](../../compatibility.mdx)
- Cluster meets [system requirements](../requirements.mdx)
- A [Tigera license key and credentials](../calico-enterprise.mdx)

Expand Down
2 changes: 1 addition & 1 deletion calico-enterprise/getting-started/install-on-clusters/kubernetes/quickstart.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ A Linux host that meets the following requirements.

### Install Kubernetes

1. [Follow the Kubernetes instructions to install kubeadm](https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/install-kubeadm/). For a compatible version for this release, see [Support and compatibility](../../compatibility.mdx#kubernetes-kubeadm).
1. [Follow the Kubernetes instructions to install kubeadm](https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/install-kubeadm/). For a compatible version for this release, see [Support and compatibility](../../compatibility.mdx).

:::note

Expand Down
2 changes: 1 addition & 1 deletion calico-enterprise/getting-started/install-on-clusters/rancher.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ The geeky details of what you get:

**Required**

- A [compatible RKE cluster](../compatibility.mdx#rke)
- A [compatible RKE cluster](../compatibility.mdx)

For help, see [Rancher Kubernetes Engine cluster](https://rancher.com/docs/rke/latest/en/). Note that RKE2 is a different Kubernetes distribution and [documented separately](rke2.mdx).

Expand Down
2 changes: 1 addition & 1 deletion calico-enterprise/getting-started/install-on-clusters/rke2.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ The geeky details of what you get:

**Required**

- A [compatible RKE2 cluster](../compatibility.mdx#rke2) with 2.6.5 or later
- A [compatible RKE2 cluster](../compatibility.mdx) with 2.6.5 or later

For help, see [Rancher Kubernetes Engine cluster](https://rancher.com/docs/rke/latest/en/).

Expand Down
2 changes: 1 addition & 1 deletion calico-enterprise/getting-started/install-on-clusters/tkg.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ The geeky details of what you get:

**Required**

- A [compatible TKG cluster](../compatibility.mdx#tkg)
- A [compatible TKG cluster](../compatibility.mdx)
- Configure your cluster for $[prodname] CNI
The workload cluster must be configured with `CNI: none`. When the workload cluster is bootstrapped, the nodes will be in a `NotReady` state until $[prodname] is installed. For more information, see [Tanzu networking](https://docs.vmware.com/en/VMware-Tanzu-Kubernetes-Grid/1.4/vmware-tanzu-kubernetes-grid-14/GUID-tanzu-k8s-clusters-networking.html) and [Tanzu configuration file reference](https://docs.vmware.com/en/VMware-Tanzu-Kubernetes-Grid/1.4/vmware-tanzu-kubernetes-grid-14/GUID-tanzu-config-reference.html).

Expand Down
2 changes: 1 addition & 1 deletion calico-enterprise/getting-started/install-on-clusters/windows-calico/rancher.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Install $[prodnameWindows] on Rancher Kubernetes Engine (RKE).

**Required**

- A [compatible RKE cluster](../../compatibility.mdx#rke)
- A [compatible RKE cluster](../../compatibility.mdx)

- An RKE cluster provisioned with [no network plugin](https://rancher.com/docs/rke/latest/en/config-options/add-ons/network-plugins#disabling-deployment-of-a-network-plug-in)

Expand Down
2 changes: 1 addition & 1 deletion ...enterprise/getting-started/upgrading/upgrading-enterprise/openshift-upgrade.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Always check the [Release Notes](../../../release-notes/index.mdx) for exception

## Prerequisites

Ensure that your $[prodname] OpenShift cluster is running a supported version of [OpenShift Container Platform](../../compatibility.mdx#openshift), and the $[prodname] operator version is v1.2.4 or greater.
Ensure that your $[prodname] OpenShift cluster is running a supported version of [OpenShift Container Platform](../../compatibility.mdx), and the $[prodname] operator version is v1.2.4 or greater.

:::note

Expand Down
2 changes: 1 addition & 1 deletion ...rise_versioned_docs/version-3.20-2/_includes/components/InstallOpenshiftBeforeYouBegin.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ export default function InstallOpenshiftBeforeYouBegin(props) {
<ul>
<li>
<p>
A <Link href={`${baseUrl}/getting-started/compatibility#openshift`}>compatible OpenShift cluster</Link>
A <Link href={`${baseUrl}/getting-started/compatibility`}>compatible OpenShift cluster</Link>
</p>
<p>
Your environment meets the {prodname}{' '}
Expand Down
Loading
Loading