What is repmgr?

repmgr is an open-source tool suite to manage replication and failover in a cluster of PostgreSQL servers. It enhances PostgreSQL's built-in hot-standby capabilities with tools to set up standby servers, monitor replication, and perform administrative tasks such as failover or manual switchover operations.

repmgr has provided advanced support for PostgreSQL's built-in replication mechanisms since they were introduced in 9.0, and repmgr 2.0 supports all PostgreSQL versions from 9.0 to 9.4. With further developments in replication functionality such as cascading replication, timeline switching and base backups via the replication protocol, the repmgr team has decided to use PostgreSQL 9.3 as the baseline version for repmgr 3.0, which is a substantial rewrite of the existing repmgr code and which will be developed to support future PostgreSQL versions.

Open Source from 2ndQuadrant

repmgr is developed by 2ndQuadrant, the global experts in PostgreSQL support, training, development, migration and consultancy.

repmgr is free and open-source software licensed under the GNU Public License (GPL) v3. This means you are free to use and modify repmgr as you see fit, however any modifications you make may only be distributed under the same terms. See here for details.

Contributions to repmgr are welcome. See the CONTRIBUTING.md file for information about how to contribute.


Online documentation which describes the installation process and the most common usage patterns is available in the project GitHub repository.

See the Quickstart guide (HTML version) for a brief conceptual overview and installation examples.

Upgrading from repmgr 2.0 to repmgr 3.0 is straightforward; see the release notes for details.

Instructions for uninstalling repmgr can be found here.

2ndQuadrant Logo