Skip to main content

Supported Releases

This page lists the status, timeline and policies for currently supported releases.

Upgrade to Chaos Mesh 2.8

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.

info

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​

info

Support for Kubernetes 1.22 is available starting with version 2.0.4.

info

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.

VersionCurrently SupportedRelease DateEnd of LifeSupported Kubernetes versions
masterNo, development only--1.35, 1.36, 1.37
2.8YesOct 01, 2025-1.35, 1.36, 1.37
2.7Security updates onlySep 20, 2024-1.26, 1.27, 1.28
2.6NoMay 31, 2023Oct 01, 20251.20, 1.21, 1.22, 1.23, 1.24, 1.25, 1.26, 1.27, 1.28
2.5NoNov 22, 2022Sep 20, 20241.20, 1.21, 1.22, 1.23, 1.24, 1.25
2.4NoSep 23, 2022May 31, 20231.20, 1.21, 1.22, 1.23, 1.24, 1.25
2.3NoJul 29, 2022Nov 22, 20221.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 1.22
2.2NoApr 29, 2022Sep 23, 20221.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 1.22
2.1NoNov 30, 2021Jul 29, 20221.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 1.22
2.0NoJul 23, 2021Apr 29, 20221.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 1.22
1.2NoApr 23, 2021Nov 30, 20211.12, 1.13, 1.14, 1.15
1.1NoJan 08, 2021Jul 23, 20211.12, 1.13, 1.14, 1.15
1.0NoSep 25, 2020Apr 23, 20211.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:

VersionTested Kubernetes Versions
master1.35, 1.37
2.81.35, 1.37
2.71.26.13, 1.27.10, 1.28.6
2.61.20.15, 1.23.4, 1.25.1