The table below shows the versions of Kubernetes on which Domino validates its software. Validation is performed for the following providers: AWS, Azure, Google Cloud, Red Hat OpenShift, and Rancher.
For security and stability, Domino encourages customers to keep their Kubernetes infrastructure up to date running a version of Domino we’ve officially validated. Outdated or unvalidated combinations of Domino and Kubernetes may affect the supportability of your deployment.
Every 12-14 months, Kubernetes versions reach end-of-life (EOL) and may no longer be supported by the Kubernetes provider. If you have questions about the compatibility and upgrade path, contact Domino customer support for assistance.
Work with Domino to align your installation and upgrade planning with the guidance below:
-
Domino ships major or minor releases approximately every 3 months. Strive to keep your Domino deployments updated with the latest releases by upgrading every 3 to 6 months. Skipping multiple versions of Domino results in larger gaps in Kubernetes version compatibility and more complex upgrades.
-
Each Kubernetes provider has a different release schedule for specific versions of Kubernetes. Domino strives to support new Kubernetes releases within approximately 3 months of the generally available release date.
-
Domino should be upgraded onto a supported Kubernetes version (see compatibility table below). When you upgrade Kubernetes, you should immediately upgrade to a supported Domino version.
-
Domino recommends keeping Kubernetes control plane and data plane at the same version, minimizing version skew.
Domino Nexus hybrid deployments
Nexus control planes require the same Kubernetes cluster requirements as any other Domino deployment.
However, Nexus data planes have the following differences:
-
No requirement for shared storage (RWX storage class).
-
Requires only one (compute) namespace.
-
Ingress configuration is different, see Enable a Data Plane for Workspaces for more information.
-
Kubernetes version compatibility may be different from the control plane (see table below).
The following matrix shows the supported combinations of Domino and Kubernetes platform versions. For inquiry about unlisted Kubernetes distributions, contact your Domino professional services representative.
End of life (EOL) for Kubernetes versions is dictated by the Kubernetes platform provider. For more information on what EOL means for each platform, see the links in the Kubernetes Platform column.
Nexus data plane
The table below shows the minimum supported version of Kubernetes for Nexus data planes by platform and Domino version. Supported versions may differ for Nexus data planes deployed on vClusters.
| Control Plane Domino Version | ||
|---|---|---|
Platform Type | 6.0.x | 5.11.x |
non-vCluster | 1.26 | 1.26 |
vCluster | 1.27 | 1.27 |
Domino doesn’t publish a validated container runtime compatibility matrix and recommends using the default container runtime version provided by your vendor. However, if your Kubernetes nodes use Docker, it should be 20.10.24 or higher.