gitwtfhub

wtf is ch-ops?

quantrail-data/ch-ops — explained in plain English

Analysis updated 2026-05-18

22JavaScriptAudience · ops devopsComplexity · 3/5LicenseSetup · moderate

TL;DR

A web dashboard that puts a visual interface in front of ClickHouse databases, letting you run SQL, monitor queries, manage backups, and control access without the command line.

Mindmap

mindmap
  root((CHOps))
    What it does
      Visual ClickHouse admin
      Query monitoring
      Backup management
    Tech stack
      Bun
      React
      Express
    Features
      SQL editor
      Alerting
      Access control
    Use cases
      Cluster monitoring
      Backup restore
      Role management

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Monitor ClickHouse cluster health and kill slow or runaway queries from a browser.

REASON 2

Set up SQL based alert rules that email you when a threshold is crossed.

REASON 3

Manage ClickHouse user roles and permissions visually instead of with raw SQL grants.

REASON 4

Schedule and restore backups to S3 compatible storage.

What's in the stack?

JavaScriptBunReactExpressSQLiteClickHouse

How it stacks up

quantrail-data/ch-opsalgorave-dave/fail-safeavaritiachaos/qoder-proxy
Stars222222
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderateeasymoderate
Complexity3/51/53/5
Audienceops devopsgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Needs a reachable ClickHouse server plus Bun or Docker, and a required session secret before it will start.

A copyleft license (AGPL v3): you can use and modify it, but if you run a modified version as a network service, you must share your source code too.

Wtf does this do

CHOps is a web based dashboard for managing and watching over ClickHouse database clusters. ClickHouse is a type of database built for fast analytics on large amounts of data, and people normally interact with it through a command line tool or a raw HTTP API. CHOps puts a visual interface in front of that, so instead of typing commands you can click through pages to run SQL, watch slow queries, set up alerts, manage backups, and control who has access. The dashboard is organized into ten sections reachable from a sidebar, along with a global search that jumps straight to any page or feature. These sections cover cluster health and live query monitoring, a full SQL editor with autocomplete and query explain plans, custom chart dashboards, index and log viewers, alerting rules with email notifications, user and role management, and backup and restore to S3 compatible storage. There is also a built in AI assistant, called Qurioz, that turns plain English questions into ClickHouse SQL. CHOps itself stores its own settings, such as alerts, dashboards, and user accounts, in a small local SQLite file, and does not touch your actual ClickHouse data unless you run a query yourself. It is built with Bun, a JavaScript runtime, using a React frontend and an Express backend, and can be compiled into a single self contained file that runs with no other dependencies. The easiest way to try it is downloading a ready made binary from the releases page, though it can also be run from source or through Docker with a provided Compose file. Getting it running from source involves installing Bun, pointing it at a reachable ClickHouse server, filling in four required settings such as an admin username, password, and a random session secret, then running a one time database setup command before starting the app. It is released under the AGPL v3 license, a copyleft license that generally requires anyone offering a modified version as a network service to share their source code as well. It has 22 stars so far.

Yoink these prompts

Prompt 1
Help me install CHOps using the prebuilt binary and connect it to my existing ClickHouse server.
Prompt 2
Walk me through setting the required .env values, including generating a session secret.
Prompt 3
Show me how to run CHOps in production using Docker Compose with persistent data.
Prompt 4
Explain how CHOps's AI assistant Qurioz turns plain English questions into ClickHouse SQL.

Frequently asked questions

wtf is ch-ops?

A web dashboard that puts a visual interface in front of ClickHouse databases, letting you run SQL, monitor queries, manage backups, and control access without the command line.

What language is ch-ops written in?

Mainly JavaScript. The stack also includes JavaScript, Bun, React.

What license does ch-ops use?

A copyleft license (AGPL v3): you can use and modify it, but if you run a modified version as a network service, you must share your source code too.

How hard is ch-ops to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ch-ops for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.