High-availability replication manager for PostgreSQL
Python Shell Other
Switch branches/tags
Nothing to show
Failed to load latest commit information.
docs Added check that you're not cloning from a broken replica. Some fixes… May 9, 2014
drafts Added vagrant test infrastructure for handyrep1 Oct 8, 2013
handyrepGUI remove apostrophe in possessive pronoun Aug 12, 2014
platforms/apache fix wsgi daemon process name Aug 12, 2014
test/vagrant Added Flask Daemon to handyrep. Debugged a auto-failover extensively. Jan 10, 2014
CONTRIBUTORS.txt More archiving cleanup. Added wsgi file and sample apache config. Now… Jan 30, 2014
LICENSE.txt Fixed error in README. Updated copyright. Jan 11, 2014
README.md Fixed apache/mod_wsgi configuration and sample vhost files. Feb 26, 2014
requirements.txt Added Flask Daemon to handyrep. Debugged a auto-failover extensively. Jan 10, 2014



HandyRep is a server-based tool designed to allow you to manage a PostgreSQL "replication cluster", defined as a master and one or more replicas on the same network. It is distinct from other PostgreSQL replication management tools in the following ways:

  1. Written entirely in Python, for easy hackability
  2. All functionality is accessable either as a Python library, or using a REST interface with the optional Flask application
  3. Supports user-supplied plugins to let it interface with applications in your environment.
  4. Supports automated failover logic for high availability

Among its other useful features and advantages are:

  • Can be run from a 3rd-party server (such as a pgbouncer server)
  • Can be run in a failover configuration, with a 2nd Handyrep server which doesn't accept commands (future planned feature).
  • Designed to minimize the per-node installation/configuration requirements. No "agent" is installed on the nodes.
  • Supports multiple replicas and remastering
  • Integrates 3rd-party connection failover

Further documentaton is found in the Docs folder.

Support and Collaboration

Discussion of HandyRep usage and development can be found on the HandyRep Google Group: http://groups.google.com/d/forum/handyrep

The HandyRep project is located at http://handyrep.org


HandyRep is copyright 2013-2014 PostgreSQL Experts Inc. Portions copyright its individual contributors.

It is available under The PostgreSQL License. See LICENSE.txt for details.


The HandyRep name, HandyRep logo, and PGX Logo are trademarks of PostgreSQL Experts Inc. Permission to use these trademark is granted provided that such use is in reference to PostgreSQL Experts, the HandyRep Project, software packages composed of the HandyRep Project's code, or usage or forks of the HandyRep Project code.
You may not state or imply, through such usage, ownership of these trademarks, or endorsement of any product, service, organization, or person by the HandyRep Project or PostgreSQL Experts Inc. Any other use requires written permission by PostgreSQL Experts, Inc.