Link Search Menu Expand Document Documentation Menu

Installation quickstart

This guide helps you quickly install OpenSearch and OpenSearch Dashboards using Docker. For other installation methods, see Installing OpenSearch Dashboards.

Prerequisite

Before you begin, install Docker on your machine.

Option 1: Try OpenSearch Dashboards in one command

Use this method to quickly spin up OpenSearch and OpenSearch Dashboards on your local machine with minimal setup.

This configuration disables security and should only be used in test environments.

Start OpenSearch:

docker pull opensearchproject/opensearch:latest && docker run -d -p 9200:9200 -p 9600:9600 -e "discovery.type=single-node" -e "DISABLE_SECURITY_PLUGIN=true" --name opensearch opensearchproject/opensearch:latest

Start OpenSearch Dashboards:

docker pull opensearchproject/opensearch-dashboards:latest && docker run -d -p 5601:5601 -e "OPENSEARCH_HOSTS=http://host.docker.internal:9200" -e "DISABLE_SECURITY_DASHBOARDS_PLUGIN=true" --name opensearch-dashboards opensearchproject/opensearch-dashboards:latest

After both containers start, verify that OpenSearch is running:

curl http://localhost:9200

Then open OpenSearch Dashboards at http://localhost:5601.

Option 2: Set up a Docker Compose cluster

For more control over your setup, use Docker Compose to run a multi-node cluster:

  1. Set up OpenSearch. See the OpenSearch Installation quickstart.
  2. Set up OpenSearch Dashboards. See Installing OpenSearch Dashboards with Docker.

Other installation methods

For non-Docker installation methods (tarball, RPM, Debian, Helm, Windows), see Installing OpenSearch Dashboards.

Configuring OpenSearch Dashboards

You can configure OpenSearch Dashboards settings in the opensearch_dashboards.yml file. This file controls server options, authentication, plugin settings, and features like workspaces. After changing the configuration file, restart OpenSearch Dashboards for the changes to take effect.

For a full list of settings, see Configuring OpenSearch Dashboards.

Next steps