ClickHouse Keeper
ClickHouse Keeper is a coordination service for ClickHouse clusters that manages and synchronises metadata across multiple servers, helping distributed tables…
Platform availability
Available on 3 of 10 platforms
- Unraid (not listed)
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox
- Helm
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
76/100 Good
- Maintained
- 100last commit 2 days ago
- Popular
- 9451,027 GitHub stars
- Easy to install
- 553 install platforms, install notes, Docker image
- Light to run
- 1016 GB minimum RAM
Availability: platform listings confirmed today
- GitHub stars
- 51,027
- Open issues
- 9217
- Last commit
- 2026-11-19
- Latest release
- v26.9.33.10-stable
- License
- Apache-2.0
- Activity
- declining
Checked 2 days ago - source: GitHub (ClickHouse/ClickHouse)
Resources & Compatibility
Minimum requirements: 16 GB RAM, 4 CPU core(s), 1024 GB disk.
Checked 23 days ago - source: Docker Hub image tags and published docs
First-install notes
- Check Keeper cluster members Use the get /keeper/config command after setup to see the Keeper servers in your cluster and their address/port. If a server is missing or wrong, the cluster can't reach a consensus, so coordination can fail. source
Fetched 53 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Does the ClickHouse Keeper setup guide apply to ClickHouse Cloud?
No, the self-hosting Keeper procedure is not applicable to ClickHouse Cloud. The procedure is automated in ClickHouse Cloud services.
How can I check that all Keeper servers are in the cluster?
Use the get /keeper/config command after setup to see the Keeper servers and their address/port. A missing or wrong server can prevent consensus and cause coordination to fail.
What startup order matters in a self-hosted stack that uses ClickHouse and Keeper?
Start the ClickHouse operator first, then ClickHouse and Keeper, then the migrations job, then the app pods. A failure early in that chain can make later pods wait.
Why might an organization choose self-hosting over a managed ClickHouse service?
A community poster said a managed ClickHouse service was not an option for compliance reasons.
Answers sourced from clickhouse.com, github.com, www.confident-ai.com, www.reddit.com
Community
- how to do setup for clickhouse keeper - Stack Overflow (forum)
- ClickHouse Keeper connection loss over secure channels (forum)
- Migrate Zookeeper to Clickhouse-Keeper on Instana Self-Hosted Custom ... (other)
Collected 48 days ago - public community threads