# Altinity/clickhouse-operator

Altinity Kubernetes Operator for ClickHouse creates, configures and manages ClickHouse® clusters running on Kubernetes

Repository: https://github.com/Altinity/clickhouse-operator
Canonical: https://ross.abutalabs.com/products/clickhouse-operator
Homepage: https://altinity.com
Language: Go
License: Apache-2.0
License Family: permissive
Topics: clickhouse-operator, kubernetes, clickhouse, kubernetes-operator
Last push: 2026-08-26T19:50:16+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 97, longevity 100
- inputs: {"age_days": 2792, "days_push": 7, "days_rel": 21, "gap_med": 27.5, "n_releases_24m": 21}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2558, forks 569 (observed 2026-08-28T04:07:00.872069+00:00)

## What it is
The Altinity Kubernetes Operator for ClickHouse is a Go-based Kubernetes operator that creates, configures, and manages ClickHouse clusters via custom resources. It automates provisioning, scaling, upgrades, user and configuration management, and Prometheus metrics export for ClickHouse deployments on Kubernetes.

## Use cases
- deploy a clickhouse cluster on kubernetes
- manage clickhouse users and configuration declaratively
- scale clickhouse clusters with automatic schema propagation
- upgrade clickhouse versions on kubernetes
- export clickhouse metrics to prometheus
- provision custom storage for clickhouse pods
- run clickhouse with gitops via argocd

## When to choose
- you run ClickHouse on Kubernetes and want declarative, automated cluster lifecycle management
- you need automated scaling, upgrades, and schema propagation for ClickHouse
- you want Prometheus metrics and GitOps integration for your ClickHouse deployment

## When to avoid
- you run ClickHouse outside Kubernetes or on VMs
- you use ClickHouse older than 21.11 (use operator 0.23.7 or earlier)
- you prefer a fully managed ClickHouse service rather than self-operating clusters

## Facets
- artifact type: service
- maturity: active
- function: container-orchestration, deployment, monitoring, configuration-management
- domain: databases, cloud-computing, analytics
- platform: go, cloud, self-hosted
- tags: clickhouse, kubernetes-operator, olap, database-operations, prometheus-metrics, gitops, devops, containers, kubernetes, docker

## Member repositories
- Altinity/clickhouse-operator (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:00.872069+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:23:37.312307+00:00, confidence not recorded.
  - readme: https://github.com/Altinity/clickhouse-operator (fetched 2026-08-28T04:07:00.872069+00:00, sha 13f98df7433c)
  - homepage: https://altinity.com (fetched 2026-08-29T10:06:26.855224+00:00, sha 2e4483f77935)
  - site_page: https://altinity.com/plans-and-features-clickhouse (fetched 2026-08-29T10:06:26.861434+00:00, sha a950c948bc23)
  - site_page: https://docs.altinity.com/ (fetched 2026-08-29T10:06:26.863065+00:00, sha bbc62ad56f59)
  - site_page: https://altinity.com/about-us (fetched 2026-08-29T10:06:26.864916+00:00, sha d669631e5337)
  - site_page: https://altinity.com/about-us/press-releases (fetched 2026-08-29T10:06:26.866661+00:00, sha 15df8a7b40d5)
  - site_page: https://docs.altinity.com (fetched 2026-08-29T10:06:26.868374+00:00, sha bbc62ad56f59)
  - site_page: https://altinity.com/altinity-cloud-vs-clickhouse-cloud-faq (fetched 2026-08-29T10:06:26.857878+00:00, sha bb53d77d30e7)
  - site_page: https://altinity.com/clickhouse-pricing (fetched 2026-08-29T10:06:26.859696+00:00, sha 871afe6f1224)
  - site_page: https://altinity.com/releases (fetched 2026-08-29T10:06:26.869920+00:00, sha 8cc06471b7c9)
- Data as of 2026-08-30T08:39:29.467469+00:00.