Compatibility

Validated Kubernetes and OpenBao versions, CI coverage, and the production upgrade stance.

Updated 15 October 2026 · 3 min read

On this page

The operator requires Kubernetes 1.33 or newer. The rows below describe the current validation baseline, not a blanket guarantee for every cloud, distribution, or topology.

Kubernetes versions

VersionValidationSupport posture
1.36.xPull request, nightly, release, Helm, and upgrade coveragePrimary validated line
1.35.xDaily smoke, alternating weekly full coverage, and release coverageValidated compatibility line
1.34.xDaily smoke, alternating weekly full coverage, and release coverageValidated compatibility line
1.33.xNot validated for the current release lineUpstream end of life; validate in staging before adoption
OpenShiftManifest, Helm, admission, and focused platform coverageValidate on the target cluster

OpenBao versions

The 0.5.2 release passed nine release E2E lanes on each of Kubernetes 1.34.3, 1.35.1, and 1.36.1. Its operator upgrade check covers the transition from 0.5.1 in the Development and Hardened profiles. These results apply to the released 0.5.2 artifacts; validate the exact deployment in staging.

VersionValidationProduction note
2.7.0Config parser and focused local lifecycle, upgrade, restore, and PKCS#11 qualificationPrepare external plugins before upgrading; see OpenBao 2.7 migration
2.6.3Default CI, nightly, and release target; local lifecycle, rolling-upgrade, backup, and restore qualificationOperator 0.5.2 validation target; validate the exact environment in staging
2.6.2OpenBao Operator 0.5.0 release target; rolling-upgrade source for local 2.6.3 qualificationUse the latest qualified security patch
Other 2.6.xNot individually release-gatedValidate the exact patch in staging
2.5.xHistorical rolling-upgrade source coverage; outside the default config gateUpgrade to a maintained release
2.4.xOutside the default config gateUpgrade before a new production rollout
2.3.xNot validatedOut of support scope

The configuration compatibility gate checks OpenBao 2.6.4 as a migration target and 2.7.1 as the current release. These labels describe operator validation. The upstream support policy provides best-effort support centered on the latest release and does not promise a two-minor maintenance window.

OpenBao 2.6.3 qualification

Local qualification uses Kubernetes 1.34.3 on Linux ARM64 with static unseal and operator-managed TLS. It covers fresh self-initialization, file audit output, a 2.6.2 to 2.6.3 rolling upgrade with three voters and one read replica, and S3 backup and restore with RustFS. The restore checks voter replacement, read-replica recovery, and retained data. These checks do not qualify external unseal providers, cloud storage credentials, or a pre-2.6 BlueGreen transition.

OpenBao 2.7.0 qualification

Focused qualification uses Kubernetes 1.34.3 on Linux ARM64. It covers fresh self-initialization and file audit storage, 2.6.3 to 2.7.0 rolling and BlueGreen upgrades with retained data, and S3 backup and restore with RustFS. The rolling case includes three voters and a read replica. The BlueGreen case includes a pre-upgrade snapshot, non-voter synchronization, membership changes, and service availability assertions.

The external PKCS#11 0.1.0 plugin passes SoftHSM initialization, restart, and scale tests on both 2.6.3 and 2.7.0. A one-voter PKCS#11 cluster also completes a 2.6.3 to 2.7.0 upgrade with the same cluster identity and PVCs. A separate server configuration check covers a digest-pinned OCI plugin with inferred metadata. These results do not qualify cloud KMS credentials, vendor HSMs, PKCS#11 0.2.0, or removed application plugins.

Production upgrade rule

Validate the exact Kubernetes distribution, OpenBao version, unseal mechanism, storage, networking, and upgrade strategy in staging before changing production—even when both versions appear in the validated matrix.

Search the handbook

Try “install”, “threat model”, or “compatibility”.