# Install check_postgres with Homebrew, apt, apk, dnf, zypper

Monitor Postgres databases. Version 2.26.0 via Homebrew; verified 2026-06-22. Also installable with debian: sudo apt install check-postgres.

## Install

```sh
sudo av install brew:check_postgres
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install check_postgres
```

  Evidence: local Homebrew formula metadata

### Linux

- Debian apt (92%):

```sh
sudo apt install check-postgres
```

  Evidence: Debian stable package indexes: check-postgres from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- apk (92%):

```sh
sudo apk add check_postgres
```

  Evidence: Alpine Linux edge package indexes: check_postgres from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- dnf (92%):

```sh
sudo dnf install check_postgres
```

  Evidence: Fedora Rawhide package metadata: check_postgres from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst

- zypper (92%):

```sh
sudo zypper install check_postgres
```

  Evidence: openSUSE Tumbleweed package metadata: check_postgres from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

## Package facts

- **Package key:** brew:check_postgres
- **Package manager:** Homebrew
- **Version:** 2.26.0
- **Source summary:** Monitor Postgres databases
- **Homepage:** <https://bucardo.org/wiki/Check_postgres>
- **Repository:** <https://github.com/bucardo/check_postgres>
- **Last updated:** 2026-06-22T14:03:01-07:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- check_postgres (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 2.26.0
## Project history and usage

check_postgres is a Perl monitoring plugin for PostgreSQL, designed primarily for Nagios but also documenting MRTG, Cacti, and simple output modes.

### Project history

The script copyright begins in 2007 under Greg Sabino Mullane. Its GitHub repository was created in May 2009, and the embedded documentation describes many PostgreSQL actions, output modes, rc-file support, and mailing lists for announcements and general development.

### Adoption history

The README gives both a quick Nagios-script installation path and a standard Perl Makefile.PL build path. The batch input records packaging across Homebrew, Alpine, Debian, Ubuntu, Fedora, and openSUSE families.

### How it is used

Administrators use check_postgres actions to monitor connections, locks, bloat, replication, database size, transaction age, settings checksums, pgbouncer state, and many other PostgreSQL operational signals.

### Why package nerds care

check_postgres is a classic ops package: a single Perl monitoring tool with many symlink-friendly subcommands, Nagios exit codes, packageable docs, and long-running compatibility concerns around PostgreSQL client binaries and credentials.

### Timeline

- 2007: Copyright period for check_postgres begins.
- 2009: GitHub repository created.
- 2009: Version 2.11.0 added .check_postgresrc support.
- 2017: 2.23.0 release published.
- 2023: 2.26.0 release published.
- 2025: README copyright range extends through 2025.

### Related projects

- PostgreSQL and psql are core runtime dependencies for many checks.
- Nagios, MRTG, and Cacti are documented output or integration targets.
- Bucardo hosts the official documentation and project pages.

### Sources

- <https://github.com/bucardo/check_postgres>
- <https://bucardo.org/check_postgres/check_postgres.pl.html>
- <https://raw.githubusercontent.com/bucardo/check_postgres/master/README.md>
- <https://raw.githubusercontent.com/bucardo/check_postgres/master/check_postgres.pl>


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: .check_postgresrc, ~/.check_postgresrc, /etc/check_postgresrc

## Credential files

- Unix: ~/.pgpass
- Windows: %APPDATA%\postgresql\pgpass.conf
## Other Package-Manager Records

- Debian apt - check-postgres - 2.26.0-2: normalized package name match | Debian stable package indexes: check-postgres from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | script for monitoring PostgreSQL databases | https://bucardo.org/check_postgres/
- Ubuntu apt - check-postgres - 2.26.0-1: normalized package name match | Ubuntu 24.04 LTS package indexes: check-postgres from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | script for monitoring PostgreSQL databases | https://bucardo.org/check_postgres/
- apk - check_postgres - 2.26.0-r0: normalized package name match | Alpine Linux edge package indexes: check_postgres from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | PostgreSQL monitoring script | https://bucardo.org/check_postgres/
- apk - check_postgres-doc - 2.26.0-r0: normalized package name match | Alpine Linux edge package indexes: check_postgres-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | PostgreSQL monitoring script (documentation) | https://bucardo.org/check_postgres/
- dnf - check_postgres - 2.25.0-17.fc45: normalized package name match | Fedora Rawhide package metadata: check_postgres from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | PostgreSQL monitoring script | https://bucardo.org/check_postgres/
- zypper - check_postgres - 2.26.0-1.17: normalized package name match | openSUSE Tumbleweed package metadata: check_postgres from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Postgres monitoring script | http://bucardo.org/wiki/Check_postgres
- zypper - monitoring-plugins-postgres - 2.26.0-1.17: normalized package name match | openSUSE Tumbleweed package metadata: monitoring-plugins-postgres from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Postgres monitoring script using check_postgres.pl | http://bucardo.org/wiki/Check_postgres


## Combined YAML source

View the package source record on GitHub. [combined/check_postgres.yml](https://github.com/mxcl/pkgdb/blob/main/combined/check_postgres.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
