chmonitor

Open-source operational advisor for ClickHouse — real-time monitoring plus AI-driven index/partition/materialized-view recommendations.

Automatically checked · GitHub checked 2026-11-13

chmonitor

Overview

chmonitor

chmonitor

The operational advisor for ClickHouse

Build and Test GitHub stars Latest release Docker image License

Live demo · Website · Docs · Getting started · Quick start

chmonitor v0.3 launch film

Watch the v0.3 launch film

chmonitor is a dashboard and advisor for ClickHouse. It reads system.* tables and shows what the cluster is doing — queries, merges, replication, storage, health — then recommends what to change next.

It does not apply DDL for you. Recommendations stay recommendations.

Runs the same way on Docker, Kubernetes, bare metal, or ClickHouse Cloud. Self-host it free (GPL-3.0), or use the hosted demo.

Current release: v0.3.11. Upgrading from v0.2? See Migrate to v0.3.


What it does

You needchmonitor
See the clusterOverview, topology, health checks, 30+ charts
Catch expensive workRunning, slow, failed, and historical queries
Understand dataExplorer, table size, parts, compression, TTLs
Keep replicas healthyMerges, mutations, replication queue, Keeper
Get a second opinionAI advisor: projections, skip indexes, PREWHERE, MVs
Ask in EnglishBuilt-in AI agent + MCP for Claude / Cursor
Work from a terminalchm CLI — live TUI and chm doctor

Works with multiple ClickHouse hosts from one dashboard (?host=0).

More detail: docs · AI agent · editions


Quick start

One container, pointed at any reachable ClickHouse (OSS, Altinity, or ClickHouse Cloud):

docker run -d --name chmonitor -p 3000:3000 \
  -e CLICKHOUSE_HOST=https://clickhouse.example.com:8443 \
  -e CLICKHOUSE_USER=default \
  -e CLICKHOUSE_PASSWORD=change-me \
  ghcr.io/chmonitor/chmonitor:0.3.11

Open http://localhost:3000. Pin a version tag in production; use :latest only if you want the rolling tip. Image tags carry no v prefix. The release v0.3.11 publishes 0.3.11, plus 0.3 and latest.

Want a look first? dash.chmonitor.dev — no setup.

Install the CLI:

curl -sSf https://chmonitor.dev/install.sh | bash
chm doctor

Deploy

Same CLICKHOUSE_HOST / CLICKHOUSE_USER / CLICKHOUSE_PASSWORD everywhere.

TargetGuide
Dockerdocs/operate/deploy/docker
Kubernetes (Helm)docs/operate/deploy/k8s
Cloudflare Workersdocs/operate/deploy
Railway / Render / FlyOne-click
Local developmentGetting started

Release artifacts (Docker image, Node standalone, Workers archive) are on the GitHub Releases page.


Editions

chmonitor is GPL-3.0: self-host every feature, unlimited hosts, no payment, no key. A commercial license is optional and buys paper, not features — an invoice and named vendor, priority email support for the paid term, and an opt-in listing. Same binary either way.

LicenseHostsYearlyLifetime
Personal Self HostedUnlimitedFreeFree
Team3$499$1,349
UnlimitedUnlimited$999$2,999

You do not get extra dashboard features versus the free build today. A host is one monitored connection; replicas in the same shard are not counted.

Details: Editions · Commercial license · Buy.


Sponsors

Self-hosting is free under GPL-3.0. Sponsorship is not a license — it buys no features, no support window, and no key. It funds the free build, and it earns a listing.

TierOne-offYou get
Supporter$19Your name on the sponsors page
Backer$59Your name and a link to your site on the sponsors page
Hero$99Your logo and link under the homepage hero, plus the sponsors page
Partner$199A larger hero slot, plus a short line about you on the sponsors page

Want to support the free build? Start sponsoring — from $19 one-off, or $99 to put your logo under the homepage hero.

The wall: chmonitor.dev/sponsors. A commercial license is a separate thing — see Editions.


Screenshots

Overview charts: query count, duration, and data written over time Cluster topology: nodes, shards, replicas, and Keeper quorum Cluster insights: findings, record-breaking queries, storage stats AI agent: ask about schema, storage, queries, and health SQL console: read-only SQL with history and EXPLAIN

Docs


Contribute

Issues and pull requests are welcome. Agent instructions live in AGENTS.md (CLAUDE.md includes that file).

License

GPL-3.0


Repo activity