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.