Edit this page
Report an issueVersion 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 |
