Skip to content
The documentation for Open Distro for Elasticsearch.
Branch: master
Clone or download
Latest commit 298e960 Apr 17, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github One more tweak Apr 15, 2019
_includes Adds Adobe analytics code Mar 22, 2019
.gitignore Initial documentation content. Mar 6, 2019
_config.yml Preparing for 0.8.0 Apr 4, 2019

Open Distro for Elasticsearch Documentation

This repository contains the documentation for Open Distro for Elasticsearch, a full-featured, open source distribution of Elasticsearch for analytics workloads. You can find the rendered documentation at


  1. Navigate to the repository root.

  2. Install Ruby if you don't already have it.

  3. Install Jekyll if you don't already have it:

    gem install bundler jekyll

  4. Install dependencies:

    bundle install

  5. Build:

    bundle exec jekyll serve

  6. Open http://localhost:4000/for-elasticsearch-docs/.


  1. Fork this repository.
  2. Clone your fork.
  3. Edit the Markdown files in /docs.
  4. Use Jekyll to build the content, and make sure your changes render the way you expect.
  5. Push your changes, and submit a pull request.

Content guidelines

  1. Try to stay consistent with existing content.
  2. Introduce acronyms before using them.
  3. Use bold for user interface elements, italics for key terms or emphasis, and monospace for Bash commands, file names, URIs, and code.
  4. Markdown file names should be all lowercase, use hyphens to separate words, and end in .md.

Markdown guidelines

This documentation uses a modified version of the just-the-docs Jekyll theme, which has some useful classes for labels and buttons:

[Get started](#get-started){: .btn .btn-blue }

## Get started
{: .label .label-green :}
  • Labels come in default (blue), green, purple, yellow, and red.
  • Buttons come in default, purple, blue, green, and outline.
  • Warning, tip, and note blocks are available ({: .warning }, etc.).
  • If an image has a white background, you can use {: .img-border } to add a one pixel border to the image.

These classes can help with readability, but should be used sparingly. Each addition of a class damages the portability of the Markdown files and makes moving to a different Jekyll theme (or a different static site generator) more difficult.

Besides, standard Markdown elements suffice for most documentation.

To create an auto-generated table of contents near the top of long pages, use the following snippet:

#### Table of contents
1. TOC

By design, only h2 and h3 headers are included.

If you create a new directory, name its first file and make it a parent so that the links stay pretty:

layout: default
title: Some New Page
nav_order: 4
has_children: true
has_toc: false

Code of conduct

This project has adopted an Open Source Code of Conduct.

Security issue notifications

If you discover a potential security issue in this project we ask that you notify AWS/Amazon Security via our vulnerability reporting page. Please do not create a public GitHub issue.


See the LICENSE file for our project's licensing. We will ask you to confirm the licensing of your contribution.


Copyright 2019, Inc. or its affiliates. All rights reserved.

You can’t perform that action at this time.