You can connect a self hosted OpenSearch dashboard server to an Amazon OpenSearch (managed service) hosted domain.
Amazon OpenSearch (managed service) provides an OpenSearch dashboard as part of a domain deployment. For various reasons you may choose to host your own dashboard server and connect it to your Amazon OpenSearch (managed service) domain.
This repository provides how to instructions using two deployment options
- OpenSearch dashboard deployment via. Amazon Elastic Container Service (ECS) Fargate
- OpenSearch dashboard deployment via. Docker on Linux
These instructions will help you deploy an OpenSearch dashboard server as a task on an Amazon Elastic Container Service (ECS) Fargate cluster. The Fargate task will run the OpenSearch dashboard.
To deploy an ECS task running the OpenSearch dashboard click the button below. Ensure you fill out the required CloudFormation parameters.
Once the CloudFormation deployment completes follow the steps below to access the OpenSearch dashboard hosted on ECS
- Navigate to the fargate cluster opensearch-dashboard-fargate-cluster
- Click on the task
- Use the public IP address on port 5601 in your web browser to access the OpenSearch dashboard
These instructions will help you configure and run an OpenSearch dashboard server as a docker container on a Linux machine. The OpenSearch dashboard service can be configured without SSL or with SSL
-
Install Docker and Docker compose
sudo apt-get install docker
sudo apt-get install docker-compose
-
Update the docker-compose-simple.yaml
- Replace
<domain_endpoint_url>
with the OpenSearch domain endpoint - Replace
<user_name>
- Replace
<password>
You may need to update the OpenSeach dashboard image version. The image in the sample is set to version 2.5. The version should be the same as the version of OpenSearch that your Amazon OpenSearch (managed service) domain is running
- Replace
-
Run the docker-compose-simple.yaml file and start the docker container by running
docker-compose -f <path_to_docker_compose_simple> up
-
In you web browser navigate to http://localhost:5601/ to access the OpenSearch dashboard
These instructions will help you install and run a OpenSearch dashboard server as a docker container on a Linux machine. The docker container is configured with a self-signed certificate.
-
Install Docker and Docker compose
sudo apt-get install docker
sudo apt-get install docker-compose
-
Generate a self-signed certificate and certifying authority
Install OpenSSL
sudo apt-get install openssl
Run the included script
bash generate_cert.sh
-
Update docker-compose-ssl.yaml
- Replace
<domain_endpoint_url>
with the OpenSearch domain endpoint - Replace
<user_name>
- Replace
<password>
You may need to update the OpenSeach dashboard image version. The image in the sample is set to version 2.5. The version should be the same as the version of OpenSearch that your Amazon OpenSearch (managed service) domain is running
- Replace
-
Run the docker-compose-ssl.yaml file start the docker container by running
docker-compose -f <path_to_docker_compose_ssl> up
-
In your web browser navigate to https://localhost:5601/ to access the OpenSearch dashboard. If you used a self-signed certificate your web browser may flag the website as unsecure. You will have to bypass the warning on your web browser. (For Chrome, you can type thisisunsafe to bypass the warning. Be sure you are correctly accessing the URL.)