# 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.