Skip to main content

Compatibility Matrix

Purpose: For platform engineers, documents supported version combinations across Kubernetes, operating systems, infrastructure providers, platform services, and the CLI.

Kubernetes Versions​

openCenter ReleaseKubernetes 1.31Kubernetes 1.32Kubernetes 1.33Default
2026.01✅✅✅1.33.5
2025.12✅✅—1.32.4
2025.09✅✅—1.31.6

✅ = supported and tested, — = not available in that release

Operating System Versions​

OSVersionArchitectureControl PlaneWorkerNotes
Ubuntu22.04 LTSamd64✅✅Default
Ubuntu24.04 LTSamd64✅✅
RHEL8.xamd64✅✅Requires subscription
RHEL9.xamd64✅✅Requires subscription
Rocky Linux8.xamd64✅✅
Rocky Linux9.xamd64✅✅
Windows Server2022amd64—✅Worker-only, requires Calico CNI

Infrastructure Provider Versions​

OpenStack​

ComponentMinimum VersionRecommendedNotes
Keystone (Identity)Zed2024.1 (Caracal)Application credentials required
Nova (Compute)Zed2024.1
Neutron (Network)Zed2024.1
Cinder (Block Storage)Zed2024.1CSI driver dependency
Octavia (LB)Zed2024.1Optional; required if use_octavia=true
Designate (DNS)Zed2024.1Optional; for automated DNS
Barbican (Secrets)Zed2024.1Optional

VMware vSphere​

ComponentMinimum VersionRecommendedNotes
vCenter Server7.0 U38.0 U2
ESXi7.0 U38.0 U2
vSphere CSI Driver3.03.3Included in openCenter
VM Hardware Version1921

Bare Metal​

RequirementSpecification
IPMI/BMCFor power management (optional)
NetworkL2 connectivity between nodes
StorageLocal SSD or SAN
BootPXE or pre-installed OS

Platform Service Versions​

ServiceVersion (2026.01)Helm ChartNotes
FluxCD2.4.xBuilt-insource, kustomize, helm, notification controllers
cert-manager1.18.xcert-manager/cert-manager
Kyverno1.13.xkyverno/kyverno
Keycloak26.xcodecentric/keycloakx
Calico3.29.xtigera-operatorDefault CNI
Cilium1.16.xcilium/ciliumPreview
MetalLB0.14.xmetallb/metallbBare metal / VMware only
Longhorn1.7.xlonghorn/longhorn
Prometheus Stack65.xprometheus-community/kube-prometheus-stack
Loki6.xgrafana/loki
Tempo1.10.xgrafana/tempo
Velero1.14.xvmware-tanzu/velero
Harbor1.16.xharbor/harbor
Gateway API1.2.xCRDs via kustomize
Envoy Gateway1.2.xenvoyproxy/gateway-helm
rbac-manager2.xfairwinds/rbac-manager
PostgreSQL Operator1.xzalando/postgres-operator
OpenTelemetry0.100.xopen-telemetry/opentelemetry-kube-stack

CLI Version Compatibility​

CLI VersionConfig Schemagitops-base TagsNotes
2.0.x2.02026.01, 2025.12Current
1.9.x2.02025.12, 2025.09Maintenance
1.8.x2.02025.09End of life

Only schema_version: "2.0" configurations are supported. Older schema versions require migration.

Container Runtime​

RuntimeVersionSupported
containerd1.7.x✅
containerd2.0.x✅
CRI-O1.31+⚠️ Community

Deployment Methods​

MethodProvidersStatus
KubesprayAllGA
Kamaji (hosted control plane)OpenStack, AWS, vSphereGA
kind (local dev)LocalGA
Cluster APIOpenStack, AWS, Azure, vSpherePreview

Upgrade Path​

FromToMethod
2025.09 → 2025.12In-place Kubernetes upgradeopencenter cluster upgrade
2025.12 → 2026.01In-place Kubernetes upgradeopencenter cluster upgrade
CLI 1.x → 2.xBinary replacementDownload new binary; configs auto-migrate
Schema 1.x → 2.0N/ASchema 1.x not supported; manual migration required

Known Incompatibilities​

CombinationIssueWorkaround
Cilium + OpenStack Octaviakube-proxy replacement conflicts with Octavia health monitorsUse Calico or disable kube-proxy replacement
Windows workers + CiliumCilium does not support WindowsUse Calico for mixed Linux/Windows clusters
RHEL 8 + Kubernetes 1.33cgroup v1 deprecation warningsUpgrade to RHEL 9 or enable cgroup v2
Harbor + LonghornDefault StorageClass conflictsSet explicit StorageClass in Harbor config