Link Search Menu Expand Document

Open Distro for Elasticsearch development has moved to OpenSearch. The ODFE plugins will continue to work with legacy versions of Elasticsearch OSS, but we recommend upgrading to OpenSearch to take advantage of the latest features and improvements.

Open Distro for Elasticsearch Documentation

This site contains the technical documentation for Open Distro for Elasticsearch, the community-driven, 100% open source distribution of Elasticsearch with advanced security, alerting, SQL support, automated index management, deep performance analysis, and more.

Get started

Why use Open Distro for Elasticsearch?

Open Distro for Elasticsearch is well-suited to the following use cases:

  • Log analytics
  • Real-time application monitoring
  • Clickstream analytics
  • Search backend

Open Distro for Elasticsearch combines the OSS distributions of Elasticsearch and Kibana with a large number of open source plugins. These plugins fill important feature gaps in the OSS distributions.

Component Purpose
Elasticsearch Data store and search engine
Kibana Search frontend and visualizations
Security Authentication and access control for your cluster
Alerting Receive notifications when your data meets certain conditions
SQL Use SQL or a piped processing language to query your data
Index State Management Automate index operations
KNN Find “nearest neighbors” in your vector data
Performance Analyzer Monitor and optimize your cluster
Anomaly Detection Identify atypical data and receive automatic notifications
Asynchronous Search Run search requests in the background

You can install Elasticsearch plugins individually on existing OSS clusters or use the all-in-one packages for new clusters. Most of these Elasticsearch plugins have corresponding Kibana plugins that provide a convenient, unified user interface.

Get started


  1. Install and start Docker Desktop.
  2. Run the following commands:

    docker pull amazon/opendistro-for-elasticsearch:1.13.2
    docker run -p 9200:9200 -p 9600:9600 -e "discovery.type=single-node" amazon/opendistro-for-elasticsearch:1.13.2
  3. In a new terminal session, run:

    curl -XGET --insecure https://localhost:9200 -u admin:admin

To learn more, see Install.


If you want to modify the Open Distro for Elasticsearch code and build from source, instructions are in elasticsearch/ and kibana/ of the opendistro-build repository. Likewise, you can find build instructions for the various plugins in their individual repositories. If your changes could benefit others, please consider submitting a pull request.

Get involved

Open Distro for Elasticsearch is supported by Amazon Web Services. All components are available under the Apache License, Version 2.0 on GitHub.

The project welcomes GitHub issues, bug fixes, features, plugins, documentation—anything at all. To get involved, see Contribute on the Open Distro for Elasticsearch website.