---
title: How to Upgrade PostgreSQL to a New Version
description: Upgrade your PostgreSQL cluster to the latest supported version of PostgreSQL from the control panel.
product: Databases
url: https://docs.digitalocean.com/products/databases/postgresql/how-to/upgrade-version/
last_updated: "2026-07-31"
---

> **For AI agents:** The documentation index is at [https://docs.digitalocean.com/llms.txt](https://docs.digitalocean.com/llms.txt). Markdown versions of pages use the same URL with `index.html.md` in place of the HTML page (for example, append `index.html.md` to the directory path instead of opening the HTML document).

# How to Upgrade PostgreSQL to a New Version

PostgreSQL is an open source, object-relational database built for extensibility, data integrity, and speed. Its concurrency support makes it fully ACID-compliant, and it supports dynamic loading and catalog-driven operations to let users customize its data types, functions, and more.

You can upgrade earlier versions of PostgreSQL clusters or nodes to newer versions using the [DigitalOcean Control Panel](https://cloud.digitalocean.com). The upgrade process has a small risk of downtime and data loss in case of a crash, so consider adding a [read-only node](https://docs.digitalocean.com/products/databases/postgresql/how-to/add-read-only-nodes/index.html.md) as a backup before upgrading.

**Note**:

  You may receive a compatibility check error if you try to upgrade PostgreSQL twice in quick succession (for example, if you upgrade from PostgreSQL 12 to 13 and then immediately try to upgrade from 13 to 14). This is because the prior version hasn’t finished installing. If this happens, wait a few minutes and retry the upgrade.

To upgrade a cluster to a newer version of PostgreSQL, open the [**Databases**](https://cloud.digitalocean.com/databases) page and then click the cluster you want to upgrade.

On the cluster’s **Overview** page, scroll down to the **CURRENT VERSION** section and then click **Upgrade Now**.

![The cluster's current version of PostgreSQL.](https://docs.digitalocean.com/screenshots/databases/postgresql-current-version.adbbbcd8d38122d6345f76e6fe29e03204ffd01556e91e3d311a262d893373f9.png)

Select the version of PostgreSQL you want to use.

![PostgreSQL upgrade menu.](https://docs.digitalocean.com/screenshots/databases/postgresql-upgrade.a40db89a96db3e3355646ab5e7269515dd3ce9faa802ee5304fed024dbc35ade.png)

The control panel will run an upgrade compatibility check to ensure the new version is safe to install. If the check returns `Cluster Check found no issues - Safe to install`, click **Upgrade Now**.

**Warning**:

  Once the upgrade starts, you cannot restore the PostgreSQL instance to the previous version. Similarly, you can no longer use its past backups for procedures such as Point In Time Recovery (PITR), since they were created with an earlier version of PostgreSQL.

If the upgrade check fails, address the errors in the message and retry the upgrade.

![PostgreSQL upgrade error.](https://docs.digitalocean.com/screenshots/databases/postgresql-upgrade-error.22cba5af835244dba42f407fe798a385b9c699354f01f1f1e2e839f9036ba03a.png)

To verify the upgrade was successful, log in to your database and run the following statement:

```bash
select version();
```

The statement returns the current version of PostgreSQL.

```bash
version
-------------------------------------------------------------------------------------------
PostgreSQL 12.3 on x86_64-pc-linux-gnu, compiled by gcc, a 0e5a33d4e p 6dc8de8930, 64-bit
(1 row)
```