Supported Versions
Learn about the different Search with OpenSearch release versions and what's included in each before you upgrade.
Search with OpenSearch supports several concurrent versions, for example. 1.2 and 2.3.
Every release has a build number. There are three types of releases:
Major: The first number indicates a major release. OpenSearch releases new major versions only when there's a critical mass of breaking changes, such as changes that are incompatible with existing APIs.
Minor: The second number indicates the minor version. Minor versions don't introduce breaking changes.
Patch: The third number indicates the patch. All CVE issues are addressed in monthly patching.
The available support for a version release depends on the support stage. The support stages are:
GA
Maintenance (12 months post release of newer version)
- CVE only (12 months post release of newer version)
Deprecated (Post end of CVE support stage)
The following table describes the available support for each support stage.
| Feature support | GA | Maintenance | CVE only | Deprecated |
|---|---|---|---|---|
| New features | ✔ | X | X | X |
| Cluster creation | ✔ | ✔ | X | X |
| Monthly patching | ✔ | ✔ | X | X |
| CVE | ✔ | ✔ | ✔ | X |
The following table identifies the versions currently supported, along with the support stage schedule for each version.
| OpenSearch version | GA | Maintenance | CVE only | Deprecated |
|---|---|---|---|---|
| 1.2 | May 2022 | March 2023 - March 2024 | April 2024 - September 2024 | October 2024 |
| 2.3 | March 2023 | September 2023 - September 2024 | October 2024 - March 2025 | April 2025 |
| 2.11 | March 2024 | September 2024 - September 2025 | October 2025 - March 2026 | April 2026 |
Upgrade Notifications
Search with OpenSearch sends you periodic event notifications about upcoming required upgrades. If the upgrade schedule doesn't work for your applications and you require an older version of OpenSearch, contact support.
| Time to Upgrade | Notification Period |
|---|---|
| < 180 days | Every 30 days. |
| < 30 days | Every 7 days. |
| < 7 days | Every day. |
Version Deprecation
When a Search with OpenSearch version is deprecated you're required to upgrade clusters to an available version. If you don't upgrade within the specified timeframe, clusters automatically upgrade to the latest version on the date the version is deprecated.