chmonitorDeploy
Deploy chmonitor on Docker, Kubernetes, Cloudflare Workers, Vercel, or any Node.js server — each platform page is self-contained.
Deploy chmonitor wherever your ClickHouse runs. Pick the platform that matches your infrastructure — each page below is self-contained, with install steps, every config category, and migration notes.
Platforms
Docker
Single-server self-host. Fastest path; pin a release tag. Supports none / clerk / proxy auth.
Kubernetes
Cluster-managed, multi-replica. Helm chart vendored in-repo; kustomize alternative.
Cloudflare Workers
Edge / serverless. D1 + Durable Objects for conversation store; Cron Trigger for health sweep.
Vercel
Quick hosted preview. Supports postgres or clickhouse for conversation store.
Node / standalone
Custom server, systemd, bare VM. Run bun run start or node server.js behind nginx.
Traefik
Put chmonitor behind a Traefik reverse proxy with optional ForwardAuth.
One-click deploy
Deploy to managed platforms with a single click.
Production checklist
Steps to harden and validate your deployment before going to production.
Not sure where to start?
- Running Docker already? → Docker
- On Kubernetes? → Kubernetes
- Want serverless edge? → Cloudflare Workers
- Behind Traefik / a reverse proxy? → Traefik
- Before going to production? → Production checklist
Configuration categories
Every platform shares the same configuration categories. The links below go to the reference page for each.
| Category | What it controls | Reference |
|---|---|---|
| ClickHouse connection | Hosts, credentials, query timeout, pool | Configuration |
| Query / pool tuning | Execution time, cache TTL, pool size | Configuration |
| Feature permissions | Enable/disable features; public vs authenticated access | Features |
| Authentication | none / clerk / proxy (CF Access or trusted header) | Authentication |
| AI agent | LLM key, model, control tools, agent API token | AI Agent |
| Conversation store | Browser local / agentstate / D1 / postgres / clickhouse | AI Agent |
| Health alerting | Cron sweep, webhook URL, severity threshold | Configuration |
| Branding / analytics | Title, logo, GA / PostHog / Seline | Configuration |
Related
Docker
Run chmonitor as a container or Compose service.
Kubernetes
Deploy with the vendored Helm chart or kustomize.
Cloudflare Workers
Serverless edge hosting with D1 and Cron Triggers.
Self-host (Node)
Run on a bare VM with systemd behind nginx.
Production checklist
Harden and validate before going live.
Authentication
Configure none / clerk / proxy auth providers.