Introduction
Patroni introduction, quick start, and core high-availability concepts.
Patroni is a template for high availability (HA) PostgreSQL solutions using Python. For maximum accessibility, Patroni supports a variety of distributed configuration stores like ZooKeeper, etcd, Consul or Kubernetes. Database engineers, DBAs, DevOps engineers, and SREs who are looking to quickly deploy HA PostgreSQL in datacenters — or anywhere else — will hopefully find it useful.
We call Patroni a “template” because it is far from being a one-size-fits-all or plug-and-play replication system. It will have its own caveats. Use wisely. There are many ways to run high availability with PostgreSQL; for a list, see the PostgreSQL Documentation.
Currently supported PostgreSQL versions: 9.3 to 18.
Note to Citus users: Starting from 3.0 Patroni nicely integrates with the Citus database extension to Postgres. Please check the Citus support page in the Patroni documentation for more info about how to use Patroni high availability together with a Citus distributed cluster.
Note to Kubernetes users: Patroni can run natively on top of Kubernetes. Take a look at the Kubernetes chapter of the Patroni documentation.

Patroni introduction, quick start, and core high-availability concepts.
Installation and upgrade instructions for Patroni across supported platforms.
Patroni configuration model, precedence rules, and validation tooling.
Reference for Patroni REST API endpoints and operational behaviors.
Command reference for patronictl configuration, syntax, and subcommands.
Replica imaging, bootstrap, and custom replica creation workflows.
Asynchronous and synchronous replication modes managed by Patroni.
Standby cluster setup, behavior, and replication from remote primary.
Watchdog integration and fencing considerations for Patroni clusters.
Pause and resume mode behavior for Patroni cluster management.
DCS failsafe mode behavior, requirements, and operational caveats.
Using Patroni with Kubernetes objects, labels, and service discovery.
Patroni integration details for Citus coordinator and worker groups.
Procedure to convert existing PostgreSQL data into a Patroni cluster.
Integrating Patroni with external backup and orchestration tools.
Security considerations for DCS, REST API, and credential handling.
Multi-datacenter high-availability patterns with Patroni replication.
Frequently asked questions about Patroni operation and troubleshooting.
Chronological Patroni release notes and change history.
Contribution workflow, support channels, and development guidelines.
Was this page helpful?
Thanks for the feedback! Please let us know how we can improve.
Sorry to hear that. Please let us know how we can improve.