For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.
Version support
Review the following information about released versions for kgateway.
Released versions
| Kgateway | Release date | Kubernetes | Gateway API* |
Envoy | Helm | Istio† |
|---|---|---|---|---|---|---|
| 2.3.x | 19 May 2026 | 1.31 - 1.35 | 1.3 - 1.5 | Proxy 1.37, API v3 | >= 3.12 | 1.23 - 1.27 |
| 2.2.x | 09 Feb 2026 | 1.31 - 1.35 | 1.2 - 1.4 | Proxy 1.36, API v3 | >= 3.12 | 1.23 - 1.27 |
| 2.1.x | 10 Oct 2025 | 1.31 - 1.34 | 1.2 - 1.4 | Proxy 1.35, API v3 | >= 3.12 | 1.23 - 1.27 |
| 2.0.x | 01 Apr 2025 | 1.27 - 1.31 | 1.2 | Proxy 1.34, API v3 | >= 3.12 | 1.18 - 1.23 |
* Gateway API versions: The kgateway project is conformant to the Kubernetes Gateway API specification for the standard channel. The latest kgateway and Gateway API versions support the experimental channel, but might not for older versions. For more details, see the Gateway API docs and kgateway conformance report per version, such as Gateway API v1.4.0.
† Istio versions: Istio must run on a compatible version of Kubernetes. For example, Istio 1.27 is tested, but not supported, on Kubernetes 1.28. For more information, see the Istio docs.
Release cadence
Stable builds for kgateway are released as minor versions approximately every three months. A stable branch for a minor version, such as 2.1, is tagged from main, and stable builds are supported from that branch.
Release development
New features for kgateway are developed on main and available as development builds. Stable branches are created off of main for each minor version, such as v2.0.x.
Release process
Development of a quality stable release on main typically follows this process:
- New feature development is suspended on
main. - Release candidates are created, such as
2.1.0-rc1,2.1.0-rc2, and so on. - A full suite of tests is performed for each release candidate. Testing includes all documented workflows, a test matrix of all supported platforms, and more.
- Documentation for that release is prepared, vetted, and staged.
- The stable minor version is released as part of a stable branch, such as
v2.0.x. - Feature development on
mainis resumed.
Feature development on main branch
Feature development for kgateway is performed on the main branch. Upon a merge to main, a development build is automatically released. The current development release is 2.4.0-main.
Backports to stable branches
New features are not developed on or backported to stable branches, such as v2.0.x. However, critical patches, bug fixes, and documentation fixes are backported as needed.