Upgrade to Postgres 15.x, 16.y, or 17.z
This document only applies when changing Postgres major version (i.e. from 14 to 15/16/17 or from 15 to 16/17). It doesn’e apply when upgrading minor versions (i.e. from 14.5 to 14.11).
While new cloud projects ship with Postgres 14 by default, versions 15, 16, and 17 are also supported. To change your major version you can go to Settings -> Database, select the new major version and start the process:
Keep in mind that the upgrade process requires downtime. Pay attention to all the information provided to you in the settings page.
After starting the process you can follow it on the same page:
Finally, you can confirm the upgrade by executing the SQL query SELECT version();
This process can only be triggered from the dashboard. If you have a project with a connected repository and want to upgrade postgres to a new major version you will have to follow the steps below:
nhost config pull
or edit the nhost.toml
by hand.If you attempt to change major versions via a deployment the deployment will fail. This is done on purpose to avoid unintended upgrades which can lead to downtime.
Upgrade to Postgres 15.x, 16.y, or 17.z
This document only applies when changing Postgres major version (i.e. from 14 to 15/16/17 or from 15 to 16/17). It doesn’e apply when upgrading minor versions (i.e. from 14.5 to 14.11).
While new cloud projects ship with Postgres 14 by default, versions 15, 16, and 17 are also supported. To change your major version you can go to Settings -> Database, select the new major version and start the process:
Keep in mind that the upgrade process requires downtime. Pay attention to all the information provided to you in the settings page.
After starting the process you can follow it on the same page:
Finally, you can confirm the upgrade by executing the SQL query SELECT version();
This process can only be triggered from the dashboard. If you have a project with a connected repository and want to upgrade postgres to a new major version you will have to follow the steps below:
nhost config pull
or edit the nhost.toml
by hand.If you attempt to change major versions via a deployment the deployment will fail. This is done on purpose to avoid unintended upgrades which can lead to downtime.