# Installing &repmgr; from packages

We recommend installing &repmgr; using the available packages for your system.

## RedHat/CentOS/Fedora

&repmgr; RPM packages for RedHat/CentOS variants and Fedora are available from the 2ndQuadrant public repository; see following section for details.

RPM packages for &repmgr; are also available via Yum through the PostgreSQL Global Development Group RPM repository (http://yum.postgresql.org/). Follow the instructions for your distribution (RedHat, CentOS, Fedora, etc.) and architecture as detailed there. Note that it can take some days for new &repmgr; packages to become available via the this repository.

&repmgr; packages are designed to be compatible with the community-provided PostgreSQL packages. They may not work with vendor-specific packages such as those provided by RedHat for RHEL customers, as the filesystem layout may be different to the community RPMs. Please contact your support vendor for assistance.

For more information on the package contents, including details of installation paths and relevant service commands, see the appendix section packages-centos.

### 2ndQuadrant public RPM yum repository

Beginning with repmgr 4.0.5, 2ndQuadrant provides a dedicated `yum` public repository for 2ndQuadrant software, including &repmgr;. We recommend using this for all future &repmgr; releases.

General instructions for using this repository can be found on its homepage. Specific instructions for installing &repmgr; follow below.

Installation

- Locate the repository RPM for your PostgreSQL version from the list at: https://dl.2ndquadrant.com/

- Install the repository definition for your distribution and PostgreSQL version (this enables the 2ndQuadrant repository as a source of &repmgr; packages).

  For example, for PostgreSQL 10 on CentOS, execute:

      curl https://dl.2ndquadrant.com/default/release/get/10/rpm | sudo bash

  Verify that the repository is installed with:

      sudo yum repolist

  The output should contain two entries like this:

      2ndquadrant-dl-default-release-pg10/7/x86_64        2ndQuadrant packages (PG10) for 7 - x86_64          4
      2ndquadrant-dl-default-release-pg10-debug/7/x86_64  2ndQuadrant packages (PG10) for 7 - x86_64 - Debug  3

- Install the &repmgr version appropriate for your PostgreSQL version (e.g. `repmgr10`):

      $ yum install repmgr10

Compatibility with PGDG Repositories

The 2ndQuadrant &repmgr; yum repository packages use the same definitions and file system layout as the main PGDG repository.

Normally yum will prioritize the repository with the most recent &repmgr; version. Once the PGDG repository has been updated, it doesn't matter which repository the packages are installed from.

To ensure the 2ndQuadrant repository is always prioritised, install `yum-plugin-priorities` and set the repository priorities accordingly.

Installing a specific package version

To install a specific package version, execute `yum --showduplicates list` for the package in question:

            [root@localhost ~]# yum --showduplicates list repmgr10
            Loaded plugins: fastestmirror
            Loading mirror speeds from cached hostfile
             * base: ftp.iij.ad.jp
             * extras: ftp.iij.ad.jp
             * updates: ftp.iij.ad.jp
            Available Packages
    		repmgr10.x86_64                       4.0.3-1.rhel7                        pgdg10
    		repmgr10.x86_64                       4.0.4-1.rhel7                        pgdg10
    		repmgr10.x86_64                       4.0.5-1.el7                          2ndquadrant-repo-10

then append the appropriate version number to the package name with a hyphen, e.g.:

            [root@localhost ~]# yum install repmgr10-4.0.3-1.rhel7

## Debian/Ubuntu

.deb packages for &repmgr; are available from the PostgreSQL Community APT repository (http://apt.postgresql.org/). Instructions can be found in the APT section of the PostgreSQL Wiki (https://wiki.postgresql.org/wiki/Apt).

For more information on the package contents, including details of installation paths and relevant service commands, see the appendix section packages-debian-ubuntu.

### 2ndQuadrant public apt repository for Debian/Ubuntu

Beginning with repmgr 4.0.5, 2ndQuadrant provides a public apt repository for 2ndQuadrant software, including &repmgr;.

General instructions for using this repository can be found on its homepage. Specific instructions for installing &repmgr; follow below.

Installation

- Install the repository definition for your distribution and PostgreSQL version (this enables the 2ndQuadrant repository as a source of &repmgr; packages) by executing:

      curl https://dl.2ndquadrant.com/default/release/get/deb | sudo bash

  This will automatically install the following additional packages, if not already present:

  - `lsb-release`

  - `apt-transport-https`

- Install the &repmgr version appropriate for your PostgreSQL version (e.g. `repmgr10`):

      $ apt-get install postgresql-10-repmgr

  For packages for PostgreSQL 9.6 and earlier, the package name includes a period between major and minor version numbers, e.g. `postgresql-9.6-repmgr`.