PG_LSCLUSTERS(1)

📦
version 293ubuntu1 · 8 versions
, in ubuntu stonking

🐘 PG_LSCLUSTERS ✨

okay bestie, so pg_lsclusters is literally your girl for peeking at all your PostgreSQL clusters — it shows you info about every single one of them 💅

🌸 SYNOPSIS

pg_lsclusters [options] [version [cluster]]

💖 DESCRIPTION

This command lists the status plus some config deets of all the clusters. And if you hand it a version and optionally a cluster name? It's giving only those ones, no extras. main character energy fr fr 🎀

✨ OPTIONS ✨

  • -h, --no-header — bestie does NOT want the column header line, so this just... doesn't print it. gone. bye 👋
  • -j, --json — output the info in JSON format 🦋. Heads up though: this needs JSON.pm installed (Debian package: libjson-perl). no cap, it will not work without it.
  • -s, --start-conf — include start.conf info in the status column. the tea is IN the status column now ☕
  • --help — prints usage help. your lil emergency SOS button 🫶

📝 NOTES

The cluster status shows up as online or down. And if a recovery.conf file is found in the data directory, ,recovery gets appended. 👀

okay so about that ,recovery thing — it needs read access to the data directory, and literally only root and the cluster owner have that. so if you're not one of them? no ,recovery for you 😭

The output lines are colored green and red so you can vibe-check the cluster status visually. it's giving traffic light but make it postgres 🌈

👑 AUTHOR

Martin Pitt <mpitt@debian.org>

and that's the whole page, bestie!! this one's from the Debian PostgreSQL infrastructure crew, dated 2026-07-28 🎀 go forth and check those clusters, you absolute icon 💜🔥

📦 where this page comes from