pg_isready¶
Prüft, ob ein PostgreSQL-Server Verbindungen annimmt, und meldet es als Exit-Code: ideal für Skripte und Monitoring.

Syntax¶
pg_isready [-h HOST] [-p PORT] [-d DB] [-U BENUTZER] [-t SEKUNDEN] [-q]
Optionen¶
| Option | Beschreibung |
|---|---|
-h HOST, -p PORT |
Server und Port, Standard lokaler Socket und 5432 |
-d DB, -U BENUTZER |
Datenbank und Rolle für die Prüfung (nur fürs Log) |
-t SEKUNDEN |
Zeitlimit, Standard 3 |
-q |
Keine Ausgabe, nur der Exit-Code |
Exit-Codes: 0 nimmt Verbindungen an, 1 lehnt ab (z. B. beim Starten), 2 keine Antwort, 3 kein Versuch (falsche Parameter). pg_isready meldet sich nicht an und braucht deshalb kein Passwort.
Beispiele¶
Ist der lokale Server bereit:
pg_isready
/var/run/postgresql:5432 - accepting connections
Einen Server über das Netz prüfen:
pg_isready -h 192.0.2.22 -p 5432
192.0.2.22:5432 - accepting connections
Der Server ist gestoppt:
pg_isready; echo $?
/var/run/postgresql:5432 - no response
2
Still, für Skripte:
pg_isready -q && echo ok || echo down
ok
Wann brauche ich das?¶
- In Skripten, die warten müssen, bis die Datenbank läuft, z. B. nach einem Neustart
- Als Health Check in Docker Compose oder einem Monitoring-System
- Um von einem Anwendungsserver aus schnell zu prüfen, ob die Datenbank erreichbar ist
Auf die Datenbank warten
until pg_isready -q -h db01; do sleep 1; done wartet in einem Deploy-Skript, bis die
Datenbank Verbindungen annimmt, und startet erst dann die Migration.
Unterschiede zwischen Distributionen¶
| Debian | Ubuntu | RHEL | Arch | |
|---|---|---|---|---|
| Paket | postgresql-client |
postgresql-client |
postgresql |
postgresql-libs |