ContextQMD
Back to Yugabyte Db

Upgrade universes with a new version of YugabyteDB

docs/content/v2.25/yugabyte-platform/manage-deployments/upgrade-software.md

2026.1.0.0-b253.2 KB
Original Source

{{< page-finder/head text="Upgrade YugabyteDB" subtle="across different products">}} {{< page-finder/list icon="/icons/database-hover.svg" text="YugabyteDB" url="../../../manage/upgrade-deployment/" >}} {{< page-finder/list icon="/icons/server-hover.svg" text="YugabyteDB Anywhere" current="" >}} {{< page-finder/list icon="/icons/cloud-hover.svg" text="YugabyteDB Aeon" url="/preview/yugabyte-cloud/cloud-clusters/database-upgrade/" >}} {{< /page-finder/head >}}

You can upgrade the YugabyteDB release that is powering a universe to get new features and fixes included in the release.

{{< note title="Upgrading YugabyteDB on deprecated operating systems" >}}

If your universe is running on a deprecated OS, you will need to update your OS before you can upgrade to the next major YugabyteDB release. Refer to Patch and upgrade the Linux operating system.

{{< /note >}}

{{< note title="Upgrading universes in xCluster deployments" >}} When upgrading universes in xCluster Replication or xCluster Disaster Recovery:

  • Use the same version of YugabyteDB on both the source/DR primary and target/DR replica.
  • Upgrade and finalize the target/DR replica before upgrading and finalizing the source/DR primary. {{< /note >}}

{{< warning title="Upgrading YugabyteDB to v2.25" >}} Upgrading universes to YugabyteDB v2.25 from previous preview versions is not yet available. {{< /warning >}}

When performing a database upgrade, do the following:

  1. Upgrade YugabyteDB Anywhere. You cannot upgrade a universe to a version of YugabyteDB that is later than the version of YugabyteDB Anywhere.

    For information on which versions of YugabyteDB are compatible with your version of YugabyteDB Anywhere, refer to Compatibility with YugabyteDB.

  2. Prepare to upgrade a universe. Depending on the upgrade you are planning, you may need to make changes to your automation or upgrade your Linux operating system.

  3. View and import releases. Before you can upgrade your universe to a specific version of YugabyteDB, verify that the release is available in YugabyteDB Anywhere and, if necessary, import the release.

  4. Upgrade the universe. Perform a rolling upgrade on a live universe deployment.

{{<index/block>}}

{{<index/item title="Prepare to upgrade" body="Review changes that may affect your automation." href="../upgrade-software-prepare/" icon="fa-thin fa-diamond-exclamation">}}

{{<index/item title="Manage releases" body="View and import the latest releases of YugabyteDB." href="../ybdb-releases/" icon="fa-thin fa-download">}}

{{<index/item title="Upgrade a universe" body="Perform a rolling upgrade on a live universe deployment." href="../upgrade-software-install/" icon="fa-thin fa-up-from-bracket">}}

{{</index/block>}}