Choosing a major version for an RDS for PostgreSQL upgrade - Amazon Relational Database Service

Choosing a major version for an RDS for PostgreSQL upgrade

Major version upgrades can contain changes that are not backward-compatible with previous versions of the database. New functionality can cause your existing applications to stop working correctly. For this reason, Amazon RDS doesn't apply major version upgrades automatically. To perform a major version upgrade, you modify your database manually. Make sure that you thoroughly test any upgrade to verify that your applications work correctly before applying the upgrade to your production databases. When you do a PostgreSQL major version upgrade, we recommend that you follow the steps described in How to perform a major version upgrade for RDS for PostgreSQL.

When you upgrade a PostgreSQL Single-AZ DB instance or Multi-AZ DB instance deployment to its next major version, any read replicas associated with the database are also upgraded to that next major version. In some cases, you can skip to a higher major version when upgrading. If your upgrade skips a major version, the read replicas are also upgraded to that target major version. Upgrades to version 11 that skip other major versions have certain limitations. You can find the details in the steps described in How to perform a major version upgrade for RDS for PostgreSQL.

Most PostgreSQL extensions aren't upgraded during a PostgreSQL engine upgrade. These must be upgraded separately. For more information, see Upgrading PostgreSQL extensions in RDS for PostgreSQL databases.

You can find out which major versions are available for your RDS for PostgreSQL database by running the following AWS CLI query:

aws rds describe-db-engine-versions --engine postgres --engine-version your-version --query "DBEngineVersions[*].ValidUpgradeTarget[*].{EngineVersion:EngineVersion}" --output text

The following table summarizes the results of this query for all available versions. An asterisk (*) on the version number means that version is no longer supported. If your current version is unsupported, we recommend that you upgrade to the newest minor version upgrade target or to one of the other available upgrade targets for that version.

Current source version Newest major version upgrade target Other available upgrade targets
16.3 none 16.4
16.2 none 16.4, 16.3
16.1 none 16.4, 16.3, 16.2
15.8 16.4 none
15.7 16.4 16.3, 15.8
15.6 16.4 16.3, 16.2, 15.8, 15.7
15.5 16.4 16.3, 16.2, 16.1, 15.8, 15.7, 15.6
15.4 16.4 16.3, 16.2, 16.1, 15.8, 15.7, 15.6, 15.5
15.3* 16.4 16.3, 16.2, 16.1, 15.8, 15.7, 15.6, 15.5, 15.4
15.2* 16.4 16.3, 16.2, 16.1, 15.8, 15.7, 15.6, 15.5, 15.4
14.13 16.4 15.8
14.12 16.3 15.8, 15.7, 14.13,
14.11 16.2 15.8, 15.7, 15.6, 14.13, 14.12
14.10 16.1 15.8, 15.7, 15.6, 15.5, 14.13, 14.12, 14.11
14.9 15.8 15.7, 15.6, 15.5, 15.4, 14.13, 14.12, 14.11, 14.10
14.8* 15.8 15.7, 15.6, 15.5, 15.4, 14.13, 14.12, 14.11, 14.10, 14.9
14.7.* 15.8 15.7, 15.6, 15.5, 15.4, 14.13, 14.11, 14.10, 14.9
14.6* 15.8 15.7, 15.6, 15.5, 15.4, 14.13, 14.11, 14.10, 14.9
14.5* 15.8 15.7, 15.6, 15.5, 15.4, 14.13, 14.11, 14.10, 14.9
14.4* 15.8 15.7, 15.6, 15.5, 15.4, 14.13, 14.11, 14.10, 14.9
14.3* 15.8 15.7, 15.6, 15.5, 15.4, 14.13, 14.11, 14.10, 14.9
14.2* 15.8 15.7, 15.6, 15.5, 15.4, 14.13, 14.11, 14.10, 14.9
14.1* 15.8 15.7, 15.6, 15.5, 15.4, 14.13, 14.11, 14.10, 14.9
13.16 16.4 15.8, 14.13
13.15 16.3 15.8, 15.7, 14.13, 14.12, 13.16
13.14 16.2 15.6, 14.13, 14.12, 14.11, 13.16, 13.15
13.13 16.1 15.5, 14.13, 14.12, 14.11, 14.10, 13.16, 13.15, 13.14
13.12 15.4 14.13, 14.12, 14.11, 14.10, 14.9, 13.16, 13.15, 13.14, 13.13
13.11 15.3 14.12, 14.11, 14.10, 14.9, 13.16, 13.15, 13.14, 13.13, 13.12
13.10* 15.2 14.13, 14.12, 14.11, 14.10, 14.9, 13.16, 13.14, 13.13, 13.12, 13.11
13.9* 14.13 14.12, 14.11, 14.10, 14.9, 13.16, 13.14, 13.13, 13.12, 13.11
13.8* 14.13 14.12, 14.11, 14.10, 14.9, 13.16, 13.14, 13.13, 13.12, 13.11
13.7* 14.13 14.12, 14.11, 14.10, 14.9, 13.16, 13.14, 13.13, 13.11
13.6* 14.13 14.12, 14.11, 14.10, 14.9, 13.16, 13.14, 13.13, 13.11
13.5* 14.13 14.12, 14.11, 14.10, 14.9, 13.16, 13.14, 13.13, 13.11
13.4* 14.13 14.12, 14.11, 14.10, 14.9, 13.16, 13.14, 13.13, 13.11
13.3* 14.13 14.12, 14.11, 14.10, 14.9, 13.16, 13.14, 13.13, 13.11
13.2*, 13.1* 14.13 14.12, 14.11, 14.10, 14.9, 13.16, 13.14, 13.13, 13.11
12.20 16.4 15.8, 14.13, 13.16
12.19 16.3 15.7, 14.12, 13.16, 13.15
12.18 16.2 15.6, 14.11, 13.16, 13.15, 13.14, 12.19
12.17 16.1 15.5, 14.10, 13.16, 13.15, 13.14, 13.13, 12.19, 12.18
12.16 15.4 14.9, 13.16, 13.15, 13.14, 13.13, 13.12, 12.19, 12.18, 12.17
12.15 15.3 14.8, 13.16, 13.15, 13.14, 13.13, 13.12, 13.11, 12.20, 12.19, 12.18, 12.17, 12.16
12.14* 15.2 14.7, 13.16, 13.15, 13.14, 13.13, 13.12, 13.11, 12.18, 12.17, 12.16, 12.15
12.13* 14.6 13.16, 13.15, 13.14, 13.13, 13.12, 13.11, 12.18, 12.17, 12.16, 12.15
12.12* 14.5 13.16, 13.15, 13.14, 13.13, 13.12, 13.11, 12.18, 12.17, 12.16, 12.15
12.11* 14.4 13.16, 13.15, 13.14, 13.13, 13.12, 13.11, 12.18, 12.17, 12.16, 12.15
12.10* 14.2 13.16, 13.15, 13.14, 13.13, 13.12, 13.11, 12.18, 12.17, 12.16, 12.15
12.9* 14.1 13.16, 13.15, 13.14, 13.13, 13.12, 13.11, 12.18, 12.17, 12.16, 12.15
12.8* 13.16 13.15, 13.14, 13.13, 13.12, 13.11, 12.18, 12.17, 12.16, 12.15
12.7* 13.16 13.15, 13.14, 13.13, 13.12, 13.11, 12.18, 12.17, 12.16, 12.15
12.6*, 12.5*, 12.4*, 12.3*, 12.2* 13.16 13.15, 13.14, 13.13, 13.12, 13.11, 12.18, 12.17, 12.16, 12.15
11.22 16.1 15.5, 14.10, 13.13, 12.17, 11.22-RDS.20240418

* This version is no longer supported.