Skip to main content

Technical Advisory 10015

Date​

Versions: >= v3.0.0

Date: 2025-03-31

Description​

CockroachDB was initially chosen due to its distributed nature and SQL compatibility. However, over time, it became apparent that the operational complexity and specific compatibility issues outweighed the benefits for our use case. We decided to focus on PostgreSQL to simplify our infrastructure and leverage its mature ecosystem.

Impact​

Zitadel v3 requires PostgreSQL as a database. Therefore, Zitadel v3 will not start if CockroachDB is configured as the database.

Mitigation​

To upgrade your self-hosted deployment to Zitadel v3 migrate to PostgreSQL. Please refer to this guide to mirror the data to PostgreSQL before you deploy Zitadel v3.