Windows

Like the tarball installation, we only recommend the Windows installation of Open Distro for Elasticsearch for testing and development purposes. We test on Windows 10 and Windows Server 2019, but other versions might work.

As an alternative, try Ubuntu for Windows 10, which you can use to install Debian packages.

ZIP install

  1. Download the ZIP file.

  2. Extract the file to a directory, and open that directory at the command prompt.

  3. Run Open Distro for Elasticsearch:

    .\bin\elasticsearch.bat
    

EXE install

  1. Install Java 11.

  2. Download the EXE file, run it, and click through the steps.

  3. Open the command prompt and navigate to the Open Distro for Elasticsearch install directory:

  4. Run Open Distro for Elasticsearch:

    .\bin\elasticsearch.bat
    

Verify the install

After you start Open Distro for Elasticsearch, open a second command prompt window. Then send requests to the server to verify that it is up and running:

curl -XGET https://localhost:9200 -u admin:admin --insecure
curl -XGET https://localhost:9200/_cat/plugins?v -u admin:admin --insecure

You must have curl installed for these commands to work. Alternatives include Invoke-RestMethod (only PowerShell 6 and later support the -SkipCertificateCheck flag) and Postman.

Configuration

You can modify config\elasticsearch.yml or specify environment variables as arguments using -E:

.\bin\elasticsearch.bat -Ecluster.name=odfe-cluster -Enode.name=odfe-node1 -Ehttp.host=0.0.0.0 -Ediscovery.type=single-node

For other settings, see Important settings.