Version compatibility

Related Documentation

The following table presents the general compatibility of Kong Operator with Kong Ingress Controller minor versions.

Kong Ingress Controller

Note: Kong Operator 2.0.0+ includes Kong Ingress Controller. The table below is only relevant for Kong Gateway Operator versions below 2.0.0.

Kong Ingress Controller 2.11.x 2.12.x 3.0.x 3.1.x 3.2.x 3.3.x 3.4.x
Kong Operator 1.0.x
Kong Operator 1.1.x
Kong Operator 1.2.x
Kong Operator 1.3.x
Kong Operator 1.4.x
Kong Operator 1.5.x
Kong Operator 1.6.x

General

The following table presents the general compatibility of Kong Operator with specific Kubernetes versions. Users should expect all the combinations marked with true to work and to be supported.

Kubernetes 1.25.x 1.26.x 1.27.x 1.28.x 1.29.x 1.3.x 1.31.x 1.32.x 1.33.x
Kong Operator 2.0.x

Gateway API

The following table presents the compatibility of Kong Operator with specific Gateway API versions. As Kong Operator implements Gateway API features using the upstream project, which defines its own compatibility declarations, the expected compatibility of Gateway API features might be limited to those.

Gateway API 1.0.0.x 1.1.0.x 1.2.0.x 1.3.0.x
Kong Operator 2.0.x

kubernetes-configuration CRDs

Starting with 1.5, Kong Operator works with kubernetes-configuration CRDs. These CRDs are backwards compatible with CRDs from gateway-operator 1.4 and older unless stated otherwise in the release notes in kuberentes-configuration CHANGELOG.md.

Older versions of Kong Operator used gateway-operator CRDs, packaged with the operator helm chart.

Below table contains a compatibility matrix for kubernetes-configuration CRDs and Kong Operator versions.

kubernetes-configuration 1.3.x.x 1.4.x.x
Kong Operator 1.4.x
Kong Operator 1.5.x
Kong Operator 1.6.x
Something wrong?

Help us make these docs great!

Kong Developer docs are open source. If you find these useful and want to make them better, contribute today!