PG_ISREADY(1)            PostgreSQL 18.6 Documentation           PG_ISREADY(1)

<?><?><?> (NAME)
       pg_isready - <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> PostgreSQL

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       pg_isready [connection-option...] [option...]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> pg_isready <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> PostgreSQL <?><?><?>.
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -d dbname
       --dbname=dbname
           <?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?><?> dbname <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?> (connection string) <?><?><?><?>.
           <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>.

       -h hostname
       --host=hostname
           <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?> Unix-domain <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       -p port
       --port=port
           <?><?><?><?> TCP <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?> Unix-domain <?><?> <?><?> <?><?><?><?> <?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> PGPORT <?><?><?>
           <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>
           (<?><?><?><?><?><?><?> 5432).

       -q
       --quiet
           <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>.
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>.

       -t seconds
       --timeout=seconds
           <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.
           <?><?><?><?><?> <?><?><?> 0 <?><?> <?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?><?><?><?> 3
           <?><?><?><?><?> <?><?><?>.

       -U username
       --username=username
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?> username <?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?>.

       -V
       --version
           <?><?><?><?><?> pg_isready <?><?> <?><?><?> <?><?><?><?> <?>
           <?><?><?><?> <?><?><?><?><?><?>.

       -?
       --help
           <?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> pg_isready
           <?><?> <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?>
           <?><?><?><?><?><?>.

<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)
       <?><?><?><?><?> pg_isready <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> 0<?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?> (<?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?>) <?><?><?><?><?> 1<?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> 2<?> <?>
       <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       (<?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>) <?><?><?><?><?> 3 <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?>.

<?><?><?><?> (ENVIRONMENT)
       <?><?><?><?><?> pg_isready<?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> PostgreSQL<?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> libpq <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?> 32.15 <?><?>
       <?><?><?><?><?><?>).

       <?><?><?><?><?> <?><?><?><?><?> PG_COLOR <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?>. <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> always<?> auto <?> never.

<?><?><?><?> (NOTES)
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?>:

           $ pg_isready
           /tmp:5432 - accepting connections
           $ echo $?
           0

       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?> PostgreSQL <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?>:

           $ pg_isready -h localhost -p 5433
           localhost:5433 - rejecting connections
           $ echo $?
           1

       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?> PostgreSQL
       <?><?><?><?><?><?><?><?><?>:

           $ pg_isready -h someremotehost
           someremotehost:5432 - no response
           $ echo $?
           2


PostgreSQL 18.6                      2026                        PG_ISREADY(1)