v2025.2 LTS Stable release with long-term support v2025.1 STS Stable release with standard-term support v2024.2 LTS Stable release with long-term support v2024.1 STS Stable release with standard-term support v2.20 LTS Stable release with long-term support Unsupported versions

Upgrade YugabyteDB Anywhere

If your YugabyteDB Anywhere installation was installed using YBA Installer, use YBA Installer to upgrade to a newer version. Note that you can only upgrade to a newer version; downgrades are not supported.

For more information, refer to Compatibility with YugabyteDB.

Before you begin

Review the requirements for your upgrade:

  • If you are upgrading a YugabyteDB Anywhere installation with high availability enabled, follow the instructions provided in Upgrade instances.

  • If you are running YugabyteDB Anywhere on a deprecated OS, you need to update your OS before you can upgrade YugabyteDB Anywhere to the next major release.

  • YugabyteDB Anywhere v2025.1 and later requires Python v3.10-3.11. If you are running YugabyteDB Anywhere on a system with Python earlier than 3.10, you will need to update Python on your system before you can upgrade YugabyteDB Anywhere to v2025.1 or later.

  • YugabyteDB Anywhere v2025.2 and later require all non-Kubernetes universes have node agent running on their nodes.

  • cron-based universes are no longer supported in YugabyteDB Anywhere v2025.2 and later.

For more information, refer to Prepare to upgrade.

Upgrade using YBA Installer

To upgrade using YBA Installer, first download the version of YBA Installer corresponding to the version of YugabyteDB Anywhere you want to upgrade to.

Download and extract the YBA Installer by entering the following commands:

wget https://downloads.yugabyte.com/releases/2025.2.1.0/yba_installer_full-2025.2.1.0-b141-linux-x86_64.tar.gz
tar -xf yba_installer_full-2025.2.1.0-b141-linux-x86_64.tar.gz
cd yba_installer_full-2025.2.1.0-b141/

When ready to upgrade, run the upgrade command from the untarred directory of the target version of the YugabyteDB Anywhere upgrade:

sudo ./yba-ctl upgrade

YBA Installer runs a pre-check to verify your universes are all running node agent, and none are cron-based. If the pre-check fails, fix the issues before attempting again. Refer to Prepare to upgrade for instructions. (To run only the upgrade pre-check, use the sudo ./yba-ctl preflight --upgrade command.)

If the pre-check succeeds, the upgrade takes a few minutes to complete.

When finished, use the status command to verify that YugabyteDB Anywhere has been upgraded to the target version:

sudo yba-ctl status

If you encounter errors or have any problems with an upgrade, contact Yugabyte Support.

For more information about using YBA Installer, refer to Install YugabyteDB Anywhere.