opensearchproject/opensearch-dashboards

Quick Reference:

Maintained by: https://github.com/opensearch-project
Need help? Ask questions and discuss on our community forum.
Need to an file issue? Use our https://github.com/opensearch-project/opensearch-build/issues to report problems with builds or Docker images.

Why OpenSearch?

OpenSearch is a scalable, flexible, and extensible open-source software suite for search, analytics, and observability applications derived from Elasticsearch 7.10.2 and Kibana 7.10.2 and licensed under Apache 2.0. It consists of a search engine daemon (OpenSearch) and a user interface for data administration and visualizations (OpenSearch Dashboards).

How to pull this image?

You can pull the OpenSearch Dashboards Docker image just like any other image.

bash
docker pull opensearchproject/opensearch-dashboards:latest

See https://hub.docker.com/r/opensearchproject/opensearch/tags for a list of all available versions.

Note: OpenSearch Dashboards images use Amazon Linux 2 as the base image for 1.x versions and 2.x versions up until 2.9.0, and Amazon Linux 2023 since 2.10.0. If you are using Docker Desktop, then we recommend configuring Docker to use a minimum of 4 GB of your system memory.

How to use this image?

OpenSearch Dashboards requires a running OpenSearch cluster. If you have an existing OpenSearch cluster, you can deploy an OpenSearch Dashboards node and add it to your cluster. To learn about OpenSearch Dashboards configuration, visit Getting started with OpenSearch Dashboards.

Start a cluster

Get started with an OpenSearch cluster by using Docker Compose. If you use Docker Desktop then Docker Compose is already installed on your machine and you will use the command docker compose. Otherwise, you will need to manually install Docker Compose.

If Python is installed in your environment, then you can use a utility such as pip, the package installer for Python, to install Docker Compose.

bash
pip install docker-compose

After the installation is complete, define a cluster in a Compose file. The OpenSearch Project provides sample https://github.com/opensearch-project/opensearch-build/tree/main/docker/release/dockercomposefiles you can use. Once you've created the file, use Docker Compose to build and manage your cluster.

Navigate to the directory where you saved docker-compose.yml and start your cluster. Use the -d option to run the containers in the background.

bash
docker-compose up -d

Stop the cluster with the following command.

bash
docker-compose down

If you also with to delete the associated data volumes, use the -v option.

bash
docker-compose down -v

Start using OpenSearch Dashboards

After running docker-compose up Docker will create the containers for your OpenSearch and OpenSearch Dashboards nodes. Once the containers are started and OpenSearch Dashboards is running, open a browser on your host and navigate to http://localhost:5601. The default username is admin and the default password is admin.

Want to learn more? Visit Getting started with OpenSearch Dashboards.

How is OpenSearch licensed?

OpenSearch and its included plugins are licensed under Apache License, Version 2.0.

How to contribute?

OpenSearch is, and will remain, 100% open-source under the Apache 2.0 license. As the project grows, we hope you will join us and contribute.

We want to make it easy for your to get started and remove friction - no lengthy contributor license agreement - so you can focus on writing great code.

Check out OpenSearch to learn more.