Install & Compatibility
Where this runs
tested against v4.1.3 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 37.5MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 4.3s · import 0.000s · 39MB
34MB installed
● package 34MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
Patroni
✓ import patroni
✗ from patroni import Patroni
Minimal Patroni instance using etcd as DCS. Adjust listen addresses, credentials, and PostgreSQL paths.
from patroni import Patroni
config = {
'namespace': '/service/',
'scope': 'batman',
'name': 'postgresql0',
'restapi': {'listen': '0.0.0.0:8008', 'connect_address': '127.0.0.1:8008'},
'etcd': {'host': '127.0.0.1:2379'},
'bootstrap': {
'dcs': {'ttl': 30, 'loop_wait': 10, 'retry_timeout': 10, 'maximum_lag_on_failover': 1048576},
'initdb': [{'encoding': 'UTF8'}, {'data-checksums': 'true'}],
'pg_hba': ['host replication replicator 127.0.0.1/32 md5', 'host all all 0.0.0.0/0 md5'],
'users': {'admin': {'password': 'admin', 'options': ['createrole', 'createdb']}}
},
'postgresql': {
'listen': '0.0.0.0:5432',
'connect_address': '127.0.0.1:5432',
'data_dir': 'data/postgresql0',
'bin_dir': '/usr/lib/postgresql/14/bin',
'pgpass': '/tmp/pgpass',
'authentication': {'replication': {'username': 'replicator', 'password': 'rep-pass'},
'superuser': {'username': 'postgres', 'password': 'secret-password'}},
'parameters': {'unix_socket_directories': '.'}
},
'tags': {'nofailover': False, 'noloadbalance': False}
}
patroni = Patroni(config)
patroni.run()
patroni --version
Upgrade
Version history
4.1.3latest on PyPI · released May 5, 2026
Audit
Dependencies
psycopg2-binaryrequiredRequired for PostgreSQL connectivity.
python-etcdoptionaletcd DCS support (optional if using other DCS).
python-consuloptionalConsul DCS support (optional).
kazoooptionalZooKeeper DCS support (optional).
pysyncobjoptionalRAFT consensus (optional, for standalone).