CloudNativePG
CloudNativePG is an open-source Kubernetes operator for PostgreSQL that automates deployment, backups, upgrades, failover, and monitoring for platform and…
Platform availability
Available on 1 of 10 platforms
- Unraid (not listed)
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
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.
66/100 Good
- Maintained
- 100last commit 4 days ago
- Popular
- 809,608 GitHub stars
- Easy to install
- 251 install platform, install notes
- Light to run
- No data
- Security check
- 201 serious finding, 1 minor, CI, tests, OpenSSF Scorecard 9.5/10
Based on 4 of 5 factors.
Security check: 1 serious finding
- Uses github.com/cloudnative-pg/cloudnative-pg v0.0.0-00010101000000-000000000000, which has a known critical vulnerability (Go)
Automated checks on commit e8420dd, 16 Oct 2026. Not an audit.
Availability: platform listings confirmed today
- GitHub stars
- 9,608
- Open issues
- 442
- Last commit
- 2026-11-17
- Latest release
- v1.30.2
- License
- Apache-2.0
- Activity
- rising
Checked 4 days ago - source: GitHub (cloudnative-pg/cloudnative-pg)
Resources & Compatibility
Requirements not published yet.
First-install notes
- Install the kubectl cnpg plugin Run the installation script with sudo so it puts the cnpg plugin in /usr/local/bin. This adds the kubectl cnpg command, which the docs use for status, logs, and psql shortcuts; without it, those commands won't be found. source
- Check backups are running After you start a backup, check kubectl describe backup to see the Phase: running status. If it gets stuck, the backup isn't completing and you should inspect the Events section to find the cause. source
- Monitoring ports are internal If you install the Kube-Prometheus monitoring stack, kubectl get svc should list Grafana, Alertmanager, the monitoring operator, and Prometheus as ClusterIP. ClusterIP means they are reachable only from inside the cluster, so use port-forwarding or expose a service if you want to open them from your home network. source
Fetched 53 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Does CloudNativePG rely on StatefulSets for PostgreSQL data volumes?
No. It manages the persistent volume claims for PGDATA itself instead of relying on StatefulSets.
Why do documentation examples with kubectl cnpg fail on my cluster?
You need the kubectl cnpg plugin installed. Run the installation script with sudo so it is placed in /usr/local/bin; the plugin provides status, logs, and psql shortcuts used by the docs.
How can I tell whether a CloudNativePG backup is running?
Run kubectl describe backup and look for Phase: running. If it is stuck, check the Events section to find the cause.
Why are the monitoring services unreachable from outside the cluster?
Grafana, Alertmanager, the monitoring operator, and Prometheus are ClusterIP services by default, so they are reachable only inside the cluster. Use port-forwarding or expose a service if you need access from your home network.
How does CloudNativePG handle primary failover?
The operator handles failover directly through the Kubernetes API. If the primary fails, it elects a new primary and orchestrates the transition without an external HA tool.
Does CloudNativePG support TLS for database connections?
Yes. It implements in-transit encrypted TLS connections and supports security contexts by default.
Answers sourced from cloudnative-pg.io, github.com, github.com, github.com, github.com
Community
- Does anyone have experience to share with CloudNativePG in ... - Reddit (reddit)
- Cloudnative PostgreSQL looks good : r/kubernetes - Reddit (reddit)
- Anyone using cloudnativepg in production? : r/PostgreSQL - Reddit (reddit)
Collected 48 days ago - public community threads