Supported Releases
This page lists the status, timeline and policies for currently supported releases.
We have focused on maintaining the 2.8 series and shipped many fixes to improve its stability. We recommend upgrading to the latest 2.8 patch release when possible.
TL;DR
Each release is supported for a period of six months, and we create a new release every three months.
Updated on 2026-11-09:
As we currently haven't had enough maintainers to support the release cycle, we will release new versions from time to time.
Here, new versions are minor releases such as 2.8. We publish patch releases such as 2.8.1 as needed.
Naming Scheme
Our naming scheme mostly follows Semantic Versioning 2.0.0 with v prepended to git tags and docker images:
v<major>.<minor>.<patch>
A minor release increments <minor> and resets <patch> to 0. A patch release increments <patch> within the same minor release series.
Support Status of Chaos Mesh
Support for Kubernetes 1.22 is available starting with version 2.0.4.
The 2.6 version also theoretically works fine on the 1.26, 1.27, and 1.28 versions of Kubernetes, but we do not sync the E2E tests for these versions.
| Version | Currently Supported | Release Date | End of Life | Supported Kubernetes versions |
|---|---|---|---|---|
| master | No, development only | - | - | 1.35, 1.36, 1.37 |
| 2.8 | Yes | Oct 01, 2025 | - | 1.35, 1.36, 1.37 |
| 2.7 | Security updates only | Sep 20, 2024 | - | 1.26, 1.27, 1.28 |
| 2.6 | No | May 31, 2023 | Oct 01, 2025 | 1.20, 1.21, 1.22, 1.23, 1.24, 1.25, 1.26, 1.27, 1.28 |
| 2.5 | No | Nov 22, 2022 | Sep 20, 2024 | 1.20, 1.21, 1.22, 1.23, 1.24, 1.25 |
| 2.4 | No | Sep 23, 2022 | May 31, 2023 | 1.20, 1.21, 1.22, 1.23, 1.24, 1.25 |
| 2.3 | No | Jul 29, 2022 | Nov 22, 2022 | 1.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 1.22 |
| 2.2 | No | Apr 29, 2022 | Sep 23, 2022 | 1.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 1.22 |
| 2.1 | No | Nov 30, 2021 | Jul 29, 2022 | 1.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 1.22 |
| 2.0 | No | Jul 23, 2021 | Apr 29, 2022 | 1.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 1.22 |
| 1.2 | No | Apr 23, 2021 | Nov 30, 2021 | 1.12, 1.13, 1.14, 1.15 |
| 1.1 | No | Jan 08, 2021 | Jul 23, 2021 | 1.12, 1.13, 1.14, 1.15 |
| 1.0 | No | Sep 25, 2020 | Apr 23, 2021 | 1.12, 1.13, 1.14, 1.15 |
Support Policies
We support the two latest minor release series.
For this, we offer two types of support:
Community technical support
You can request support from the community on CNCF Slack (in the #project-chaos-mesh channel), or through the GitHub Discussions.
Security and bug fixes
We fix security issues as soon as possible, backport the fixes to both supported minor release series, and publish patch releases immediately.
For enhancements or bug fixes, we make a new patch release as needed. The 2.7 series has entered the final phase of its lifecycle. No further updates are planned for 2.7 unless a security issue is identified.
How we determine supported Kubernetes versions
After testing the compatibility of various versions of Kubernetes clusters through E2E testing, the Chaos Mesh team determines Supported Status of Chaos Mesh based on its test results.
For master and the latest stable release, the supported Kubernetes window follows the latest three minor releases maintained upstream. E2E tests cover the oldest and newest minor releases in that window. The middle minor release is not covered by E2E tests.
Below are Kubernetes versions covered by each version of the E2E tests:
| Version | Tested Kubernetes Versions |
|---|---|
| master | 1.35, 1.37 |
| 2.8 | 1.35, 1.37 |
| 2.7 | 1.26.13, 1.27.10, 1.28.6 |
| 2.6 | 1.20.15, 1.23.4, 1.25.1 |