# chmonitor

> chmonitor is a self-hosted, open-source operational advisor for ClickHouse that reads system tables for real-time monitoring and AI-driven schema recommendations.

- **Category:** Database Management
- **Licence:** GPL-3.0
- **Latest version:** chm-v0.1.5
- **Open source:** oss
- **Languages:** Typescript
- **Platforms:** Docker, Docker Compose, Kubernetes
- **Tags:** Monitoring, Dashboard, Clickhouse, Mcp, Databases, Observability, Alerting, Open Source, Self Hosted, Ai Agent, Cloudflare Workers, Cluster management, Postgres, Tanstack Start, Database Monitoring, Query Analysis, Peer Db, Duyet, Chmonitor

## Description

chmonitor is a purpose-built dashboard and advisor for ClickHouse clusters. It connects directly to ClickHouse system tables over HTTP — no exporters or agents required — and provides real-time views of queries, merges, replication, storage, and cluster health. An integrated AI agent (with MCP server at /api/mcp) offers read-only recommendations for skip indexes, projections, PREWHERE rewrites, and TTL tuning. The dashboard supports multiple ClickHouse hosts from a single instance, includes alerting with webhooks to Slack, Discord, PagerDuty, Opsgenie, Matrix, Telegram, and more, and can also monitor PeerDB replication and Postgres (beta). It runs as a single Docker container, on Kubernetes via Helm, on Cloudflare Workers, or as a standalone Node.js binary. Licensed GPL-3.0 with optional commercial licenses for invoicing and support; all features are free in the community build.

## Links

- [Homepage](https://github.com/chmonitor/chmonitor)
- [Website](https://chmonitor.dev)
- [Docker](ghcr.io/chmonitor/chmonitor)
- [Demo](https://dash.chmonitor.dev/overview?host=0)
- [Documentation](https://docs.chmonitor.dev)
- [GitHub Repository](https://github.com/chmonitor/chmonitor)
- [Blog](https://blog.chmonitor.dev)
- [Brand Assets](https://chmonitor.dev/brand)
- [Sponsors](https://chmonitor.dev/sponsors)
- [CLI](https://chmonitor.dev/cli)
- [Dashboard (Hosted Demo)](https://dash.chmonitor.dev)

---
Source: https://selfhost.directory/project/chmonitor