chmonitorClickHouse platform support matrix
Which ClickHouse versions and distributions are supported, tested in CI, or expected to work with chmonitor.
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.
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.
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 are the recommended target
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.