New CLI commands for Heroku Postgres version upgrades

Change effective on 28 May 2025

You can now prepare, start, and manage Heroku Postgres version upgrades with the new pg:upgrade:* subcommands. The new commands make the version upgrade process easier. Before using these new commands, update the Heroku CLI version with heroku update --version 10.8.0.

With these subcommands, we’re changing the functionality in the existing pg:upgrade command. Use pg:upgrade:run to upgrade your version. You can continue to use the deprecating pg:upgrade command until it reaches end-of-life, or upgrade with pg:copy. However, we recommend using the new pg:upgrade:* commands moving forward.

See Upgrading the Version of a Heroku Postgres Database for upgrade instructions.