Question: How do you delete a PostgreSQL cluster?


In PostgreSQL, a "cluster" refers to a collection of databases that are managed by a single PostgreSQL server instance. It includes the shared configuration files and all the data directories for the databases. Deleting a PostgreSQL cluster means removing all these components.

To delete a PostgreSQL cluster on a Unix-like system, you typically use the pg_dropcluster command if you're using a version of PostgreSQL provided by Debian or Ubuntu's package repositories. Here's how you can do it:

sudo pg_dropcluster [version] [cluster_name]

For example, to delete a cluster for PostgreSQL 13 named main, you would use:

sudo pg_dropcluster 13 main

Important: This command permanently deletes the cluster, including all databases and configurations contained within it. Make sure to back up any important data before proceeding.

If you're not on a Debian-based system, or you prefer doing it manually, you will need to stop the PostgreSQL service and remove the data directory. Here’s a general approach:

  1. Stop the PostgreSQL service: You can use the following command to stop the PostgreSQL service:

    sudo systemctl stop postgresql
  2. Remove the data directory: The location of the data directory depends on your installation, but common locations are /var/lib/postgresql/[version]/[cluster_name]. Remove it using:

    sudo rm -r /var/lib/postgresql/13/main
  3. Remove the configuration files (if they are not inside the data directory): These are usually located in /etc/postgresql/[version]/[cluster_name]. Remove this directory with:

    sudo rm -r /etc/postgresql/13/main
  4. Restart the PostgreSQL service (if necessary): If you have other clusters or plan to recreate a cluster, restart the service:

    sudo systemctl start postgresql

By following these steps, you will have successfully deleted a PostgreSQL cluster. Always ensure that you have backups of any important data before deleting database clusters.

Was this content helpful?

White Paper

Free System Design on AWS E-Book

Download this early release of O'Reilly's latest cloud infrastructure e-book: System Design on AWS.

Free System Design on AWS E-Book
Start building today

Dragonfly is fully compatible with the Redis ecosystem and requires no code changes to implement.