Compatibility & Support Matrix

ClickHouse versions

CH-UI talks to ClickHouse over the HTTP interface and reads standard system tables. It works with current ClickHouse releases and ClickHouse Cloud.

Pro analytics rely on system tables present in modern ClickHouse:

• Query Insights — system.query_log (enable query logging)
• Cluster Health — system.clusters, system.replicas, system.merges, system.mutations, system.parts, Keeper tables
• Governance — system.grants, system.tables, system.columns

Browsers

The web UI targets current evergreen browsers — the latest two stable versions of Chrome, Edge, Firefox, and Safari. Internet Explorer is not supported.

Platforms

The server is distributed as a static binary (no CGO) and a multi-arch Docker image (ghcr.io/caioricciuti/ch-ui). A Helm chart ships under deploy/helm/ch-ui. See Deployment.

Architecture

CH-UI is a single-instance application: it stores state in a local SQLite database and keeps tunnel state in memory. Run one instance behind a load balancer for TLS/routing — do not run multiple replicas against one database.

Sizing guidance

CH-UI itself is lightweight; heavy work runs in ClickHouse. Starting points:

Disk grows with stored query history, audit logs, and governance metadata. Streaming query results are capped server-side rather than buffered, so large result sets do not scale memory linearly. Scrape /metrics to track real usage — see Monitoring & SIEM.