Skip to content
Database

CockroachDB Releases

Track every CockroachDB release from latest stable to end-of-life. Version timelines, PostgreSQL compatibility, licensing changes, and upgrade guidance.

Total Versions

Supported

Latest

Version Timeline

All tracked releases with lifecycle status and EOL dates.

Loading version data…

Lifecycle Timeline

Visual overview of active support and maintenance windows.

v22.1
v22.2
v23.1
v23.2
v24.1
v24.2
v24.3
2022 2023 2024 2025 2026 2027 2028
Active
Maint
Active
Maint
Active
Maint
Active
Maint
Active
Maint
Active
Maint
Active
Maint
Active / LTS
Maintenance
Today

Upgrade Paths

Migration guidance between major versions — breaking changes, effort estimates, and tips.

v23.1 v23.2 Low Difficulty
Est. 1-2 hours

Breaking Changes

  • Physical Cluster Replication (preview)
  • Improved PostgreSQL compatibility
  • User-defined functions enhancements
  • Multi-region performance improvements

Migration Notes

Rolling upgrade. One node at a time. Finalize with SET CLUSTER SETTING version = "23.2" after all nodes upgraded.

v23.2 v24.1 Low Difficulty
Est. 1-2 hours

Breaking Changes

  • Stored procedures (SQL) improvements
  • Trigram indexes for text search
  • Row-level TTL improvements
  • Enhanced changefeed performance

Migration Notes

Standard rolling upgrade. No major breaking changes. Finalize version after all nodes upgraded.

Version Risk Assessment

Evaluate risk factors before choosing a version for production.

Version EOL Risk CVE Risk Ecosystem Cloud Support Overall Recommended Action
CockroachDB v22.x and below Critical Medium EOL Dropped Critical Past EOL — upgrade one version at a time
CockroachDB v23.1/v23.2 High Low Maintenance Full High Approaching EOL — upgrade to v24.x
CockroachDB v24.1+ Low Low Active Full Low Current — keep on latest

Risk combines EOL status, PostgreSQL compat level, and cloud tier availability. Assessed as of March 2026.

Version Feature Comparison

Side-by-side feature differences across major versions.

Feature v23.1 v23.2 v24.1 v24.2
PG wire protocol compat High Higher Higher Higher
Stored procedures Stable Enhanced Enhanced Enhanced
Triggers No No Preview Preview
Physical replication No Preview Stable Stable
Trigram indexes No No Stable Stable
User-defined functions Stable Enhanced Enhanced Enhanced
Row-level TTL Stable Stable Improved Improved
Changefeeds Stable Enhanced Enhanced Enhanced
License BSL BSL BSL BSL

Embed Badges

Add live CockroachDB status badges to your README, docs, or dashboard.

Health Status

Overall support health

CockroachDB Health Status
![CockroachDB Health Status](https://img.releaserun.com/badge/health/cockroachdb.svg)

EOL Countdown

Next end-of-life date

CockroachDB EOL Countdown
![CockroachDB EOL Countdown](https://img.releaserun.com/badge/eol/cockroachdb.svg)

Latest Version

Current stable release

CockroachDB Latest Version
![CockroachDB Latest Version](https://img.releaserun.com/badge/v/cockroachdb.svg)

CVE Status

Known vulnerabilities

CockroachDB CVE Status
![CockroachDB CVE Status](https://img.releaserun.com/badge/cve/cockroachdb.svg)

Frequently Asked Questions

Common questions about CockroachDB releases and lifecycle.

Is CockroachDB compatible with PostgreSQL?
CockroachDB uses the PostgreSQL wire protocol and supports most PostgreSQL SQL syntax. You can use psql, pg drivers, and most ORMs. However, some PostgreSQL features are not supported: stored procedures (added in v23.1), triggers, and some extensions. Compatibility improves with each release.
What happened with CockroachDB licensing?
CockroachDB was Apache 2.0 through v19.1. It switched to the Business Source License (BSL) in v19.2 (2019). BSL restricts offering CockroachDB as a managed service but allows all other use. The code converts to Apache 2.0 after 3 years. CockroachDB Core (free tier) remains available.
CockroachDB vs PostgreSQL: when should I use each?
Use CockroachDB when you need: global distribution across regions, automatic horizontal scaling, built-in multi-region data residency, or zero-downtime schema changes. Use PostgreSQL when you need: maximum extension ecosystem, lower operational complexity, lower cost for single-region deployments, or full SQL feature compatibility.
How hard is it to upgrade CockroachDB?
CockroachDB supports rolling upgrades with zero downtime. Upgrade one node at a time. The cluster continues serving traffic during the upgrade. After all nodes are upgraded, finalize the upgrade to enable new features. You can only upgrade one major version at a time.
Is CockroachDB Serverless production-ready?
CockroachDB Serverless (now CockroachDB Basic) is production-ready for small-to-medium workloads. It auto-scales, has a generous free tier (10 GiB storage, 50M request units/month), and requires zero operational overhead. For high-performance or compliance-sensitive workloads, use CockroachDB Standard or Self-Hosted.

Related Tools