Versioning policy

Gen 2

When you provision a Cloud Databases instance, you can choose from the versions currently available on IBM Cloud®. Currently, only the latest versions are available for Gen 2 Cloud Databases and this is shown in the catalog pages, the Resource Controller CLI, or the Resource Controller API.

Major versions defined

Major versions for Gen 2 Cloud Databases
Service	Versioning schema	Next known end of life version and date	Preferred major version	End of life procedure
Databases for MongoDB	Major versions are the first two numbers in a `major.x.patch` version number. In cases where `x` is even, it is a stable release suitable for production. Even `x` versions are the only ones available on Cloud Databases.	v6, 30 July 2025, v7, 26 Aug 2026	v7.0	Automatically upgraded in place to next Major version
Databases for PostgreSQL	The major version is defined by the first number in the version number.	v13, 22 October 2025	v17	Automatically upgraded in place to next major version

Deprecation of major versions

Cloud Databases aims to support a major version for approximately 3 years from its release. If a version is deprecated or marked end of life by the upstream open source maintainers, Cloud Databases will initiate its own deprecation process.

When a major version is deprecated, a six-month transition window is opened for current users of the deprecated version. At the beginning of the period, we contact users affected by the deprecation. During the six-month transition window, users are able to initiate an upgrade to a supported major version. Existing instances continue to run as normal.

Restoration of existing instances into new instances of the deprecated major version is available during the six-month deprecation, although we recommend upgrading to a nondeprecated major version as soon as possible.

At the end of the transition window, deprecated major versions cannot be deployed on Cloud Databases. A backup of the instance is taken and access to instances that are running a deprecated version is removed or instances are automatically upgraded to the next major version. The backup is available to be restored into a new supported version.

Backups are retained for 30 days only. Requests to re-enable disabled formations of end-of-life versions cannot not accommodated.

Failure to act can result in compatibility issues with your apps when IBM upgrades in-place. On rare occasions, failure can result, impacting your availability. If a failure occurs, the instance is disabled, and you need to restore from backup. We recommend self-migrating before the end of support date.

Version tags

Currently, only one version per Gen 2 Cloud Databases service is supported. As new versions become available, the following version tags will apply.

Cloud Databases Version tags
Version tag	Description
Preferred	The recommended and default version for all new instances. It's the most stable, up-to-date version from both an instance-level and service-level perspective.
Preview	A preview version is released for a limited time to try available functions. Often it is the newest available version available from the project maintainers in preparation for making it the "Preferred" version. While deployable, preview versions are not suitable for production, as they are excluded from service-level agreements and support. Also, a preview version isn't guaranteed to become a production-level release. IBM reserves the right to ask a customer to delete an instance that uses a preview version.
Deprecated	Old versions and versions near their end of life dates are marked as "Deprecated". Provisions and restores of instances that run a deprecated version are still available and instances that run a deprecated version continue to be supported. However, you are encouraged to upgrade to the new "Preferred" version as deprecated versions are eventually removed from IBM Cloud and are no longer provisionable, restorable, or supported.
Untagged	Untagged versions are fully supported and deployable versions. They are usually slightly older than the current preferred version, but they are still supported by the project maintainers. They continue to be supported on Cloud Databases instances until their deprecation is announced.
Hidden	A hidden version cannot be provisioned. Existing instances that are using a version marked as hidden are still able to be restored to the hidden version.

Minor versions

IBM Cloud is committed to providing secure, up-to-date versions of services. As updates are released by project maintainers, they are tested, evaluated, and released to Cloud Databases instances. Your instance's minor version and patch updates are handled automatically and are not user configurable.

Major versioning end of life notifications

You receive multiple notifications when a major version reaches its end of life. You can typically expect:

A Cloud status page announcement, for example: End of support notices.
An announcement in your service's release notes, for example: IBM Cloud® Databases for PostgreSQL version 12 end of life on January 22, 2025.
A notification by email through the IBM API. This email contains a Notifications link that takes you to a Notifications Management page. Make sure that these announcements are not being caught by your email service's spam filter. For more information, see Setting up distribution lists for IBM Cloud notifications){:external}.
Ensure that your account is enabled to receive notifications and announcements. You must enable toggle to receive platform and resource updates. Turn on major and minor toggle under the Platform tab > Announcements > Major and Minor, and service updates under the Resource tab > Resource Activity > Service Updates. For more information, see Setting email preferences for notifications.

For more information, see Programmatic methods for checking version status. Customers are encouraged to use programatic ways, via CLI or API, to get updated about database version status. For more information, see Programmatic methods for checking version status.

Any actions taken after an EOL date happen over several days after the EOL date. We try, but cannot guarantee, to make these upgrades outside of business hours in the local regions. If you want more control over the upgrade process of your instance, we recommend that you upgrade following our backup and restore process before the EOL date of your version.

Programmatic methods for checking version status

Via an API Gen 2 Cloud Databases utilize the Resource Controller API for operation purposes. The following command gets the full data that is associated with a deployment. This data includes the ID, name, database type, and version.

GET /v2/resource_instances/{id}`

Example request:

curl -X GET https://resource-controller.cloud.ibm.com/v2/resource_instances/8d7af921-b136-4078-9666-081bd8470d94 -H "Authorization: Bearer <IAM token>" \