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

Monitor Postgres databases. Version 2.26.0 via Homebrew; verified 2026-06-22.

## 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

- 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

- 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

- 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/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-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/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

## Package facts

- **Package key:** brew:check_postgres
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/check_postgres>
- **Version:** 2.26.0
- **Source summary:** Monitor Postgres databases
- **Homepage:** <https://bucardo.org/wiki/Check_postgres>
- **Repository:** <https://github.com/bucardo/check_postgres>
- **Upstream docs:** <https://bucardo.org/check_postgres>
- **License:** BSD-2-Clause
- **Source archive:** <https://bucardo.org/downloads/check_postgres-2.26.0.tar.gz>
- **Last updated:** 2026-06-22T14:03:01-07:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- check_postgres (cli)
- check_postgres (alias)

## Dependencies

- libpq

## Uses from macOS

- perl

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_big_sur, arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, monterey, sonoma, ventura, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.26.0
- Package-manager updated: 2026-06-22
- Local data: ok
- Upstream repository: https://bucardo.org/wiki/Check_postgres
- info: Release/tag comparison is only available for GitHub repositories.
## 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
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** check_postgres
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## 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-16.fc44: 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/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | PostgreSQL monitoring script | https://bucardo.org/check_postgres/
- zypper - check_postgres - 2.26.0-1.15: normalized package name match | openSUSE Tumbleweed package metadata: check_postgres from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Postgres monitoring script | http://bucardo.org/wiki/Check_postgres
- zypper - monitoring-plugins-postgres - 2.26.0-1.15: normalized package name match | openSUSE Tumbleweed package metadata: monitoring-plugins-postgres from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Postgres monitoring script using check_postgres.pl | http://bucardo.org/wiki/Check_postgres


## Related links

- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [libpq](https://www.automicvault.com/pkg/brew/libpq/) - Runtime dependency declared by Homebrew.
- [dolphie](https://www.automicvault.com/pkg/brew/dolphie/) - Shares av.db curated category or tags: cli, data, databases, monitoring.
- [apache-geode](https://www.automicvault.com/pkg/brew/apache-geode/) - Shares av.db curated category or tags: cli, data, database, databases.
- [cassandra](https://www.automicvault.com/pkg/brew/cassandra/) - Shares av.db curated category or tags: cli, data, database, databases.
- [cdb](https://www.automicvault.com/pkg/brew/cdb/) - Shares av.db curated category or tags: cli, data, database, databases.
- [cql](https://www.automicvault.com/pkg/brew/cql/) - Shares av.db curated category or tags: cli, data, database, databases.
- [ephemeralpg](https://www.automicvault.com/pkg/brew/ephemeralpg/) - Shares av.db curated category or tags: cli, data, databases, postgresql.
- [fourstore](https://www.automicvault.com/pkg/brew/fourstore/) - Shares av.db curated category or tags: cli, data, database, databases.
- [garnet](https://www.automicvault.com/pkg/brew/garnet/) - Shares av.db curated category or tags: cli, data, database, databases.
- [pgslice](https://www.automicvault.com/pkg/brew/pgslice/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, data, database, databases, libpq.
- [pgsync](https://www.automicvault.com/pkg/brew/pgsync/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, data, database, databases, libpq.

## Combined YAML source

View the package source record on GitHub. [combined/check_postgres.yml](https://github.com/automic-vault/db/blob/main/combined/check_postgres.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
