# cloudnative-pg/cloudnative-pg

The most popular Kubernetes Operator for PostgreSQL.

Repository: https://github.com/cloudnative-pg/cloudnative-pg
Canonical: https://ross.abutalabs.com/products/cloudnative-pg
Homepage: https://cloudnative-pg.io
Language: Go
License: Apache-2.0
License Family: permissive
Topics: postgres, postgresql, kubernetes, k8s, database, sql, operator, database-management, high-availability, self-healing, disaster-recovery, business-continuity, prometheus-exporter, json-logging, replication, failover, automated-failover, devops, kubectl-plugin, switchover
Last push: 2026-08-26T15:27:26+00:00

## Health v2 (maintenance only)
Score: 96/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 90, longevity 100
- inputs: {"age_days": 1637, "days_push": 7, "days_rel": 65, "gap_med": 6.5, "n_releases_24m": 37}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 9205, forks 750 (observed 2026-08-28T04:10:28.906214+00:00)

## What it is
CloudNativePG is an open-source Kubernetes operator that manages the full lifecycle of highly available PostgreSQL clusters using native streaming replication. It integrates directly with the Kubernetes API to automate deployment, failover, backups, and declarative role management without external HA tools like Patroni.

## Use cases
- run postgresql on kubernetes
- automated failover for postgres clusters
- manage postgres databases declaratively with gitops
- set up high availability postgres with primary/standby replication
- backup and disaster recovery for postgres in k8s
- monitor postgres with prometheus
- self-healing postgres database clusters

## When to choose
- you run PostgreSQL workloads on Kubernetes and want a CNCF-backed, actively maintained operator
- you want Kubernetes-native HA without Patroni, repmgr, or Stolon
- your team uses GitOps and declarative configuration for database management
- you need integrated backup, TLS, monitoring, and rolling updates out of the box

## When to avoid
- your databases run on VMs or bare metal outside Kubernetes
- you need multi-database support beyond PostgreSQL
- you have no Kubernetes cluster and just want a simple Postgres deployment
- you require fine-grained control via external HA tooling you already operate

## Facets
- artifact type: service
- maturity: stable
- function: database, deployment, monitoring, backup, configuration-management
- domain: databases, cloud-computing, self-hosted
- platform: go, cloud, self-hosted
- tags: postgresql, kubernetes-operator, high-availability, failover, replication, disaster-recovery, gitops, prometheus-exporter, kubectl-plugin, cnpg, devops, containers, kubernetes, docker

## Member repositories
- cloudnative-pg/cloudnative-pg (main) score 96

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:28.906214+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-29T17:23:17.752653+00:00, confidence not recorded.
  - readme: https://github.com/cloudnative-pg/cloudnative-pg (fetched 2026-08-28T04:10:28.906214+00:00, sha 2fdc411c0996)
  - homepage: https://cloudnative-pg.io (fetched 2026-08-29T08:23:12.432848+00:00, sha df805f8caddb)
  - site_page: https://cloudnative-pg.io/docs (fetched 2026-08-29T08:23:12.444943+00:00, sha 217190bf6e56)
  - site_page: https://cloudnative-pg.io/docs/devel/quickstart (fetched 2026-08-29T08:23:12.446860+00:00, sha 3c4f110864c5)
  - site_page: https://cloudnative-pg.io/releases (fetched 2026-08-29T08:23:12.442581+00:00, sha 0ee318bbce51)
- Data as of 2026-08-30T08:39:29.467469+00:00.