Version-specific breaking changes for ClickHouse Private components. Review this page before upgrading.
helm/onprem-clickhouse-cluster version 1.1.245 — Shared Catalog and Stateless Servers enabled by default
Starting with chart version 1.1.245, featureFlags.enableSharedCatalog and featureFlags.disableMetadataPersistentVolumes default to true. New installations will use the Shared database engine and stateless Server nodes out of the box.
New installations require no action — the new defaults apply automatically.
Existing installations not yet on Shared Catalog must explicitly set the previous defaults to avoid an unintended migration on upgrade:
When you are ready to migrate, follow the Migrate to Shared Catalog guide.
Existing installations already on Shared Catalog require no action — the new defaults match your current configuration.
helm/onprem-clickhouse-cluster version 1.1.210
Starting with chart version 1.1.210, new config constraints are included by default. If you are using a ClickHouse server version lower than 25.10, you must exclude these constraints by adding the following to your server configuration:
Without this configuration, ClickHouse will fail to start as these settings are not recognized by versions prior to 25.10. Last modified on August 7, 2026
