# ClickHouse Keeper

ClickHouse Keeper is a coordination service for ClickHouse clusters that manages and synchronises metadata across multiple servers, helping distributed tables stay consistent during high traffic or failures. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/6420/clickhouse-keeper

## Description

ClickHouse Keeper is a coordination service for ClickHouse clusters that manages and synchronises metadata across multiple servers, helping distributed tables stay consistent during high traffic or failures.

## Platform availability

Available on 3 of 10 platforms: Proxmox, Helm, Any server.

## Health score

76/100 (Good), based on 4 of 4 factors.
- Maintained: 100 (last commit 2 days ago)
- Popular: 94 (51,027 GitHub stars)
- Easy to install: 55 (3 install platforms, install notes, Docker image)
- Light to run: 10 (16 GB minimum RAM)

## Links

- GitHub: https://github.com/ClickHouse/ClickHouse
- Docker Hub: https://hub.docker.com/r/bitnami/clickhouse-keeper
- Official website: https://clickhouse.com
- Documentation: https://clickhouse.com/docs/fr

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/6420/clickhouse-keeper), the self-hosted and open-source app directory.
