ClickHouse Platform Support Matrix

AUTO-GENERATED — do not edit this file directly. Edit scripts/build-support-matrix.ts and re-run:

bun run scripts/build-support-matrix.ts

Last generated: 2026-06-18

---

chmonitor connects to ClickHouse over the HTTP interface and reads system tables. This page documents which ClickHouse distributions and versions are tested or expected to work.

Support levels

Symbol	Level	Meaning
✓	Supported	Tested in CI or known to work end-to-end. Regressions are treated as bugs and fixed promptly.
◐	Best-effort	Expected to work based on API compatibility. Not systematically tested. Issues are investigated but fixes are not guaranteed.
—	Untested	Architecture may be compatible but no test coverage exists. Use at your own risk.

---

Versions × distributions

Version	ClickHouse OSS	Altinity Stable	ClickHouse Cloud	chDB	CHProxy
23.3 (LTS)	✓	◐	◐	—	—
23.8 (LTS)	✓	◐	◐	—	—
24.3 (LTS)	✓	◐	◐	—	—
24.8 (LTS)	✓	◐	◐	—	—
25.x	✓	◐	◐	—	—
26.x	✓	◐	◐	—	—

---

Distribution notes

Symbol	Distribution	Notes
✓ Supported	ClickHouse OSS	Primary target. Tested in CI against LTS releases.
◐ Best-effort	Altinity Stable	API-compatible with OSS; community-reported issues only.
◐ Best-effort	ClickHouse Cloud	Compatible via HTTPS connector; some system tables may be restricted by service tier.
— Untested	chDB	Embeds ClickHouse but exposes a different interface. Not tested.
— Untested	CHProxy	Protocol-level proxy; dashboard connects to the upstream cluster directly, not through CHProxy.

---

LTS versions

Long-term support (LTS) releases — currently 23.3, 23.8, 24.3, 24.8 — are the recommended deployment targets. They receive patches for a longer period from the ClickHouse team and are the versions exercised in CI.

Supported major version series: 23, 24, 25, 26.