Compatibility

AOSC has two version axes:

• AOSC version: the plugin release version, such as 0.1.0. A single version supports both OpenSearch lines.
• OpenSearch line: the OpenSearch major line an individual artifact targets, such as os2 or os3.

develop builds both lines, and each AOSC version is released once (tagged v<version>) with a ZIP per supported OpenSearch minor across both lines, because OpenSearch plugins are loaded with version compatibility checks. Documentation is versioned by AOSC version only, for example /0.1.0/.

The tables below are generated at docs-build time from release/os2.properties and release/os3.properties (the single source of truth), so they always match what this version of AOSC actually builds and validates.

OpenSearch 2.x line

Primary OpenSearch version	2.19.0
Shipped minors (one ZIP each)	2.15, 2.16, 2.17, 2.18, 2.19
Validated versions (CI)	2.15.0, 2.16.0, 2.17.0, 2.17.1, 2.18.0, 2.19.0, 2.19.1, 2.19.2, 2.19.3, 2.19.4, 2.19.5, 2.19.6
Java version	11
Gradle version	8.7

OpenSearch 3.x line

Primary OpenSearch version	3.7.0
Shipped minors (one ZIP each)	3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 3.6, 3.7
Validated versions (CI)	3.0.0, 3.1.0, 3.2.0, 3.3.0, 3.3.1, 3.3.2, 3.4.0, 3.5.0, 3.6.0, 3.7.0
Java version	21
Gradle version	8.7 (3.7 → 9.4.1)

The ZIP name includes the OpenSearch minor it was built for:

opensearch-aosc-0.1.0-os3.6.zip
opensearch-aosc-0.1.0-os2.19.zip

Use the ZIP matching your OpenSearch minor. A 3.6 ZIP is intended for the 3.6.x patch line, and a 2.19 ZIP is intended for the 2.19.x patch line, unless a release note says otherwise.

Compatibility Policy

Patch-level compatibility is validated by CI for the exact OpenSearch versions listed above. Other patch releases in the same OpenSearch minor may work because the plugin descriptor uses a patch-compatible semver range, but test the exact OpenSearch version before production use.

Do not install an AOSC ZIP built for a different OpenSearch minor unless the release notes explicitly say it is supported.