It’s time to upgrade to OpenSearch!

The Open Distro project bundled open source distributions of Elasticsearch and Kibana with Apache-2.0-licensed plugins that gave users enterprise-grade features, security, and analytics tools. In the two years since it launched, builders all over the world have used Open Distro to power their applications.

Open source Elasticsearch and Kibana 7.10.2 will soon be end of life, and are no longer receiving active development, security patches, or bugfixes. All users should be running software that receives timely security patches. The OpenSearch project was launched to provide a path forward for open source Elasticsearch and Open Distro users that ensures they always have access to security and new innovation.

Now is the time to migrate to OpenSearch to take advantage of the newest features, performance improvements, bugfixes, and security patches. See what’s so great about OpenSearch and get help migrating.

Latest News

The Future of Open Distro

Open Distro in an Apache 2.0-licensed distribution of software that includes open source Elasticsearch and Kibana packaged with a number of feature-adding plugins built by AWS. The open source Elasticsearch and Kibana portions of the...

Update to Open Distro 1.13.3

Open Distro 1.13.3 is an important security update. You can get it now on the download page. This version contains a patch for the recently published security notice (CVE-2021-44228) which affects the broadly-used Apache Log4j...

Forward to OpenSearch

For future news regarding this project and OpenSearch, please visit OpenSearch.org. In the coming weeks this website (https://opendistro.github.io/for-elasticsearch/) will be selectively decommissioned and/or forwarded to the corresponding OpenSearch.org content.

Read more posts on our blog.

Download

Try Open Distro

The best way to try out Open Distro is to use Docker Compose. These steps will setup a two node cluster of Elasticsearch plus Kibana:

  1. Download docker-compose.yml into your desired directory
  2. Run docker-compose up
  3. Have a nice coffee while everything is downloading and starting up
  4. Navigate to http://localhost:5601/ for Kibana
  5. Login with the default username (admin) and password (admin)

For further details about using Open Distro on Docker, see our documentation.

You can also find the standalone docker images on Docker Hub:
          version: '3'
          services:
            odfe-node1:
              image: amazon/opendistro-for-elasticsearch:1.13.3
              container_name: odfe-node1
              environment:
                - cluster.name=odfe-cluster
                - node.name=odfe-node1
                - discovery.seed_hosts=odfe-node1,odfe-node2
                - cluster.initial_master_nodes=odfe-node1,odfe-node2
                - bootstrap.memory_lock=true # along with the memlock settings below, disables swapping
                - "ES_JAVA_OPTS=-Xms512m -Xmx512m" # minimum and maximum Java heap size, recommend setting both to 50% of system RAM
              ulimits:
                memlock:
                  soft: -1
                  hard: -1
                nofile:
                  soft: 65536 # maximum number of open files for the Elasticsearch user, set to at least 65536 on modern systems
                  hard: 65536
              volumes:
                - odfe-data1:/usr/share/elasticsearch/data
              ports:
                - 9200:9200
                - 9600:9600 # required for Performance Analyzer
              networks:
                - odfe-net
            odfe-node2:
              image: amazon/opendistro-for-elasticsearch:1.13.3
              container_name: odfe-node2
              environment:
                - cluster.name=odfe-cluster
                - node.name=odfe-node2
                - discovery.seed_hosts=odfe-node1,odfe-node2
                - cluster.initial_master_nodes=odfe-node1,odfe-node2
                - bootstrap.memory_lock=true
                - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
              ulimits:
                memlock:
                  soft: -1
                  hard: -1
                nofile:
                  soft: 65536
                  hard: 65536
              volumes:
                - odfe-data2:/usr/share/elasticsearch/data
              networks:
                - odfe-net
            kibana:
              image: amazon/opendistro-for-elasticsearch-kibana:1.13.3
              container_name: odfe-kibana
              ports:
                - 5601:5601
              expose:
                - "5601"
              environment:
                ELASTICSEARCH_URL: https://odfe-node1:9200
                ELASTICSEARCH_HOSTS: https://odfe-node1:9200
              networks:
                - odfe-net
          
          volumes:
            odfe-data1:
            odfe-data2:
          
          networks:
            odfe-net:

Install Open Distro for production

For production we recommend using Docker.

Develop with Open Distro

If you want to run Open Distro in a non-production environment, these artifacts are a great place to start. On a Mac, we suggest using Docker.

Ingest data to Open Distro

Open Distro is compatible with a variety of ingestion and processing tools including beats, logstash, fluentbit and fluentd. The project also maintains specific ingestion tools:

Data Prepper

Data Prepper is a component of Open Distro that receives trace data from the OpenTelemetry collector, and aggregates, transforms, and normalizes it for analysis and visualization in Kibana.

Also available on Docker. A version without the bundled JDK is in the full downloads list

Trace Analytics Demo

The best way to try trace analytics with Data Prepper is to use Docker Compose.

  1. Git clone the Data Prepper github project: git clone https://github.com/opendistro-for-elasticsearch/Data-Prepper.git

  2. Change to example trace-analytics-sample-app directory: cd Data-Prepper/examples/trace-analytics-sample-app

  3. Launch Docker Compose: docker-compose up -d

  4. Access the sample application: Point your browser at http://localhost:8089/

From here you can follow the instructions on the Introduction to Trace Analytics announcement blog post.

Find out what’s included in an installation of Open Distro

Open Distro is made up of two primary components - Elasticsearch and Kibana. Each component consists of the core binaries plus plugins, everything licensed under Apache 2.0. We also provide previous releases and standalone plugins.

Latest: 1.13.3 / Date: Dec 11, 2021 / Release Notes

Get a list of all the Open Distro downloads

A comprehensive list of all artifacts associated with the Open Distro project.