Database version policies

Select a documentation version:

This page describes the support, retirement, and compatibility policies for AlloyDB Omni major and minor versions, and the AlloyDB Omni Kubernetes operator.

For information about AlloyDB for PostgreSQL version policies, see AlloyDB for PostgreSQL database version policies.

AlloyDB Omni version policies

Every version of AlloyDB Omni has compatibility with a specific version of PostgreSQL, as detailed in Support policy.

Because AlloyDB Omni is software that you install and run yourself, you are responsible for regularly updating your AlloyDB Omni installation. Learn about the latest versions of AlloyDB Omni in the AlloyDB Omni release notes.

For AlloyDB Omni, you must download and install the binaries that include upgraded PostgreSQL minor version compatibility. Some AlloyDB Omni releases are updates to AlloyDB Omni itself, independent of updates to PostgreSQL support. These releases include bug fixes and security updates, and are reflected in an incremental increase of the third number in the release version. For example, the 2 in 18.1.2 indicates an update to AlloyDB Omni.

Support policy

Google provides support for AlloyDB Omni versions and the AlloyDB Omni operator based on the following timelines:

Version type Support period
Major versions Supported for 5 years from the initial release date, matching the community support lifecycle of the underlying PostgreSQL version.
Minor versions Supported for 1 year from their specific release date.
Kubernetes operator versions Supported for 1 year from their specific release date. To find the release date for an operator version, see [AlloyDB Omni release notes](/alloydb/omni/kubernetes/current/docs/release-notes).

Major version support timeline

The following table lists the general availability (GA) dates of AlloyDB Omni support for PostgreSQL major versions. These dates serve as the "initial release date" for calculating the 5-year support window.

PostgreSQL major version GA date
18 April 9, 2026
17 December 15, 2025
16 April 8, 2025
15 October 11, 2023

Once a version exceeds its support period, it is considered retired. Google doesn't process support tickets for retired versions and recommends that you upgrade to a supported version to continue receiving assistance.

Supported PostgreSQL versions

AlloyDB Omni supports compatibility with the following PostgreSQL database versions:

PostgreSQL version AlloyDB Omni version Status
18.1 18.1.1 Supported
18.1 18.1.0 Supported
17.7 17.7.0 Supported
16.11 16.11.0 Supported
15.15 15.15.0 Supported
17.5 17.5.0 Retired
16.9 16.9.0 Retired
16.8 16.8.0 Retired
16.3 16.3.0 Retired
15.17.1 15.17.1 Retired
15.13 15.13.0 Retired
15.12 15.12.0 Retired

Patch policy

To ensure the security and stability of your environment, Google applies patches for critical bugs and vulnerabilities according to the following policy:

  • Patches are applied only to the latest minor version of each supported major version.
  • If you encounter an issue on an older minor version, you must upgrade to the latest available minor version of that major version to receive the fix.

Upgrade and compatibility

The version numbers for AlloyDB Omni indicate the version of PostgreSQL they support using the format MAJOR_VERSION.MINOR_VERSION.OMNI_PATCH_VERSION. The major and minor version numbers match the version of the underlying PostgreSQL engine, while the third number represents the AlloyDB Omni patch version.

Some AlloyDB Omni releases are updates to AlloyDB Omni itself, independent of updates to PostgreSQL support. These releases include bug fixes and security updates, and are reflected in an incremental increase of the third number in the release version. For example, the 2 in 18.1.2 indicates an update to AlloyDB Omni.

Policy category Description
Major version timing

We aim to support new PostgreSQL major versions within eight months of the release of the first minor release, version x.1, of a new PostgreSQL major version.

For AlloyDB Omni in Google Distributed Cloud, we aim to support compatibility with a new major PostgreSQL version within four months of its availability in AlloyDB Omni.

Minor version timing We aim to release support for new PostgreSQL minor versions every quarter. Because AlloyDB Omni is software that you install and run yourself, you must download and install the binaries that include upgraded PostgreSQL minor version compatibility.
Upgrade order You must upgrade the AlloyDB Omni operator before upgrading your database clusters (dataplanes).
Security updates We aim to release fixes within one month of a PostgreSQL community security release.
Operator compatibility The operator is designed to manage dataplanes up to 1 year old.
Upgrade path
  • You may skip minor or patch versions during an upgrade, provided the version gap does not exceed the 1-year support period.
  • Rollbacks are only supported to the version used immediately prior to the upgrade.

Data protection

The AlloyDB Omni operator doesn't perform automatic backups before an upgrade. You are responsible for taking a manual backup of your data before triggering an upgrade process.

What's next