This page explains Cockroach Labs' policy for supporting major releases of CockroachDB.
For CockroachDB Cloud clusters, see the CockroachDB Cloud Upgrade Policy.
Support cycle
Each major release of CockroachDB goes through the following support cycle:
Maintenance Support: For at least 365 days from the major release date, Cockroach Labs will produce regular patch releases that include critical security fixes and resolutions to problems identified by users.
Assistance Support: Following the maintenance support period, Cockroach Labs will provide assistance support for at least an additional 180 days. During this period, the following guidelines will apply:
- New enhancements and error corrections will not be made to the major release.
- Cockroach Labs will direct customers to existing fixes/patches and workarounds applicable to the reported case.
- Cockroach Labs may direct customers to upgrade to a more current version of the product if a workaround does not exist.
- Cockroach Labs will continue to add critical security fixes to the major release in the form of patch releases.
End of Life (EOL): Following the assistance support period, Cockroach Labs will no longer provide any support for the release.
Cockroach Labs will notify you by mail or email 6 months in advance of a major release transitioning into Assistance Support or EOL.
Current supported releases
As of v19.1, Cockroach Labs uses a three-component calendar versioning scheme. Prior releases use a different versioning scheme. For more details, see Release Naming.
Date format: YYYY-MM-DD
| Version | Release Date | Maintenance Support ends | Assistance Support ends (EOL Date) |
|---|---|---|---|
| v23.1 | 2023-05-15 | 2024-05-15 | 2024-11-15 |
| v22.2 | 2022-12-05 | 2023-12-05 | 2024-06-05 |
| v22.1* | 2022-05-24 | 2023-05-24 | 2023-11-24 |
| v21.2* | 2021-11-16 | 2022-11-16 | 2023-05-16 |
| v21.1* | 2021-05-18 | 2022-05-18 | 2022-11-18 |
| v20.2* | 2020-11-10 | 2021-11-10 | 2022-05-10 |
| v20.1* | 2020-05-12 | 2021-05-12 | 2021-11-12 |
| v19.2* | 2019-11-12 | 2020-11-12 | 2021-05-12 |
| v19.1* | 2019-04-30 | 2020-04-30 | 2020-10-30 |
| v2.1* | 2018-10-30 | 2019-10-30 | 2020-04-30 |
| v2.0* | 2018-04-04 | 2019-04-04 | 2019-10-04 |
| v1.1* | 2017-10-12 | 2018-10-12 | 2019-04-12 |
| v1.0* | 2017-05-10 | 2018-05-10 | 2018-11-10 |
* Version has reached EOL
Was this helpful?
