Skip to content
Kong Logo | Kong Docs Logo
search
  • We're Hiring!
  • Docs
    • Kong Gateway
    • Kong Konnect
    • Kong Mesh
    • Plugin Hub
    • decK
    • Kubernetes Ingress Controller
    • Insomnia
    • Kuma

    • Docs contribution guidelines
  • Plugin Hub
  • Support
  • Community
  • Kong Academy
Get a Demo Start Free Trial
  • Kong Gateway
  • Kong Konnect
  • Kong Mesh
  • Plugin Hub
  • decK
  • Kubernetes Ingress Controller
  • Insomnia
  • Kuma

  • Docs contribution guidelines
  • 2.8.x (latest)
  • 2.7.x
  • 2.6.x
  • 2.5.x
  • 2.4.x
  • 2.3.x
  • 2.2.x
  • 2.1.x
  • 2.0.x
  • 1.3.x
  • 1.2.x
  • 1.1.x
  • 1.0.x
    • FAQ
    • Version Support Policy
    • Stages of Software Availability
    • Changelog
    • Architecture
    • Custom Resources
    • Deployment Methods
    • Kong for Kubernetes with Kong Enterprise
    • High-Availability and Scaling
    • Resource Classes
    • Security
    • Ingress Resource API Versions
    • Gateway API
    • Kong Ingress on Minikube
    • Kong for Kubernetes
    • Kong for Kubernetes Enterprise
    • Kong for Kubernetes with Kong Enterprise
    • Kong Ingress on AKS
    • Kong Ingress on EKS
    • Kong Ingress on GKE
    • Admission Webhook
    • Installing Gateway APIs
    • Getting Started with KIC
    • Upgrading from previous versions
    • Upgrading to Kong 3.x
    • Getting Started using Istio
      • Using the KongPlugin Resource
      • Using the KongIngress Resource
      • Using KongConsumer and KongCredential Resources
      • Using the TCPIngress Resource
      • Using the UDPIngress Resource
    • Using the ACL and JWT Plugins
    • Using cert-manager with Kong
    • Allowing Multiple Authentication Methods
    • Configuring a Fallback Service
    • Using an External Service
    • Configuring HTTPS Redirects for Services
    • Using Redis for Rate Limiting
    • Integrate KIC with Prometheus/Grafana
    • Configuring Circuit-Breaker and Health-Checking
    • Setting up a Custom Plugin
    • Using Ingress with gRPC
    • Setting up Upstream mTLS
    • Exposing a TCP Service
    • Exposing a UDP Service
    • Using the mTLS Auth Plugin
    • Configuring Custom Entities
    • Using the OpenID Connect Plugin
    • Rewriting Hosts and Paths
    • Preserving Client IP Address
    • Using Kong with Knative
    • Using Multiple Backend Services
    • KIC Annotations
    • CLI Arguments
    • Custom Resource Definitions
    • Plugin Compatibility
    • Version Compatibility
    • Supported Kong Router Flavors
    • Troubleshooting
    • Prometheus Metrics
    • Feature Gates
    • Supported Gateway API Features

github-edit-pageEdit this page

report-issueReport an issue

enterprise-switcher-iconSwitch to OSS

On this page
  • Kong
  • Kong Enterprise
  • Kubernetes
    • General
    • Gateway API
  • Istio
Kubernetes Ingress Controller
2.8.x (latest)
  • Home
  • Kubernetes Ingress Controller
  • References
  • Version Compatibility

Version Compatibility

Kong’s 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

By Kong, we are here referring to the official distribution of the Open-Source Kong Gateway.

Kubernetes Ingress Controller 2.1.x 2.2.x 2.3.x 2.4.x 2.5.x 2.6.x 2.7.x 2.8.x
Kong 1.5.x
Kong 2.0.x
Kong 2.1.x
Kong 2.2.x
Kong 2.3.x
Kong 2.4.x
Kong 2.5.x
Kong 2.6.x
Kong 2.7.x
Kong 2.8.x
Kong 3.0.x

Kong Enterprise

Kong Enterprise is the official enterprise distribution, which includes all other enterprise functionality, built on top of the Open-Source Kong Gateway.

Kubernetes Ingress Controller 2.1.x 2.2.x 2.3.x 2.4.x 2.5.x 2.6.x 2.7.x 2.8.x
Kong Enterprise 1.5.x
Kong Enterprise 2.1.x
Kong Enterprise 2.2.x
Kong Enterprise 2.3.x
Kong Enterprise 2.4.x
Kong Enterprise 2.5.x
Kong Enterprise 2.6.x
Kong Enterprise 2.7.x
Kong Enterprise 2.8.x
Kong Enterprise 3.0.x

Kubernetes

General

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

Kubernetes Ingress Controller 2.1.x 2.2.x 2.3.x 2.4.x 2.5.x 2.6.x 2.7.x 2.8.x
Kubernetes 1.16
Kubernetes 1.17
Kubernetes 1.18
Kubernetes 1.19
Kubernetes 1.20
Kubernetes 1.21
Kubernetes 1.22
Kubernetes 1.23
Kubernetes 1.24
Kubernetes 1.25
Kubernetes 1.26

Gateway API

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

Kubernetes Ingress Controller 2.4.x 2.5.x 2.6.x 2.7.x 2.8.x
Kubernetes 1.17
Kubernetes 1.18
Kubernetes 1.19
Kubernetes 1.20
Kubernetes 1.21
Kubernetes 1.22
Kubernetes 1.23
Kubernetes 1.24
Kubernetes 1.25
Kubernetes 1.26

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

Istio

The Kubernetes 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 Kubernetes Ingress Controller release, tests are run to verify this documentation with upcoming versions of KIC and Istio. The following table lists the tested combinations:

Kubernetes Ingress Controller 2.1.x 2.2.x 2.3.x 2.4.x 2.5.x 2.6.x 2.7.x 2.8.x
Istio 1.8
Istio 1.9
Istio 1.10
Istio 1.11
Istio 1.12
Istio 1.13
Istio 1.14
Istio 1.15
Istio 1.16
Thank you for your feedback.
Was this page useful?
  • Kong
    THE CLOUD CONNECTIVITY COMPANY

    Kong powers reliable digital connections across APIs, hybrid and multi-cloud environments.

    • Company
    • Customers
    • Events
    • Investors
    • Careers Hiring!
    • Partners
    • Press
    • Contact
  • Products
    • Kong Konnect
    • Kong Gateway
    • Kong Mesh
    • Get Started
    • Pricing
  • Resources
    • eBooks
    • Webinars
    • Briefs
    • Blog
    • API Gateway
    • Microservices
  • Open Source
    • Install Kong Gateway
    • Kong Community
    • Kubernetes Ingress
    • Kuma
    • Insomnia
  • Solutions
    • Decentralize
    • Secure & Govern
    • Create a Dev Platform
    • API Gateway
    • Kubernetes
    • Service Mesh
Star
  • Terms•Privacy
© Kong Inc. 2023