You are browsing documentation for an older version. See the latest documentation here.

Version Compatibility

Kong’s Kubernetes ingress controller is compatible with different flavors of Kong. The following sections detail on compatibility between versions for the last five controller versions. Compatibility for older versions is available in those versions’ documentation.

Kong

Kong Ingress Controller	2.12.x	3.0.x	3.1.x	3.2.x	3.3.x
Kong 2.8.x
Kong 3.4.x
Kong 3.6.x
Kong 3.7.x
Kong 3.8.x

Kong Gateway Enterprise

Kong Ingress Controller	2.12.x	3.0.x	3.1.x	3.2.x	3.3.x
Kong Gateway Enterprise 2.8.x
Kong Gateway Enterprise 3.4.x
Kong Gateway Enterprise 3.6.x
Kong Gateway Enterprise 3.7.x
Kong Gateway Enterprise 3.8.x

Kubernetes

General

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

Kong Ingress Controller	2.12.x	3.0.x	3.1.x	3.2.x	3.3.x
Kubernetes 1.27
Kubernetes 1.28
Kubernetes 1.29
Kubernetes 1.30
Kubernetes 1.31

Gateway API

The following table presents the compatibility of Kong Ingress Controller’s Gateway API with specific Kubernetes minor versions. As Kong Ingress Controller 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.

Kong Ingress Controller	2.12.x	3.0.x	3.1.x	3.2.x	3.3.x
Kubernetes 1.27
Kubernetes 1.28
Kubernetes 1.29
Kubernetes 1.30
Kubernetes 1.31

For specific Gateway API resources support, please refer to the Gateway API Support page.

Istio

The Kong Ingress Controller can be integrated with an Istio Service Mesh to use Kong Gateway as an ingress gateway for application traffic into the mesh network. See an example of this in the Istio Guide.

For each Kong Ingress Controller release, tests are run to verify this documentation with upcoming versions of KIC and Istio. The following table lists the tested combinations:

Kong Ingress Controller	2.12.x	3.0.x	3.1.x	3.2.x	3.3.x
Istio 1.21
Istio 1.22
Istio 1.23