Skip to main content
search
Technical

OpenSearch 1.0 Backwards Compatibility FAQ

By June 9, 2021March 26th, 2025No Comments

In introducing OpenSearch we said:

The Amazon OpenSearch Service APIs will be backwards compatible with the existing service APIs to eliminate any need for customers to update their current client code or applications. Additionally, just as we did for previous versions of Elasticsearch, we will provide a seamless upgrade path from existing Elasticsearch 6.x and 7.x managed clusters to OpenSearch.

Today we would like to provide mode detail, and clarify what the above statement, and compatibility in general, mean.

Upgrading from Elasticsearch OSS and Kibana OSS or Open Distro for Elasticsearch (ODFE) to OpenSearch and OpenSearch Dashboards is like upgrading between versions of Elasticsearch OSS and Kibana OSS.

Specifically:

  • OpenSearch supports rolling upgrades and restart upgrades from Elasticsearch OSS 6.8.0 through Elasticsearch OSS 7.10.2 to OpenSearch 1.0.
  • OpenSearch Dashboards supports restart upgrades from Kibana OSS 6.8.0 through Kibana OSS 7.10.2 to OpenSearch Dashboards 1.0.
  • All 1.x versions of ODFE similarly support upgrades to OpenSearch and OpenSearch Dashboards 1.0.

We’ve also added an Upgrading section to OpenSearch FAQs, and are updating the OpenSearch docs. Additional questions are welcome on the forums. Please also do open backwards compatibility bugs in GitHub issues.

Finally, we would like to note that both spellings of backwards compatibility and backward compatibility are allowed, but we prefer backwards because we created GitHub labels as backwards-compatibility and don’t want to go change everything.

Author

  • Daniel Doubrovkine (aka dB.) is a Principal Engineer at AWS in New York, working on OpenSearch. He is a seasoned entrepreneur, technologist and former CTO at Artsy.net. Daniel graduated from University of Geneva in late 90s with a degree in Computer Science. Daniel is the creator and maintainer of many popular open-source projects and a lifetime artist, currently serving as a Principal Engineer, working on the OpenSearch Project at AWS.

    View all posts
Close Menu