Using Dashboards

For guidance on using OpenSearch Dashboards see the documentation here.

Dashboards quickstart guide

Lucenia is compatible with OpenSearch Dashboards. Use the following docker compose and opensearch_dashboards.yml to run OpenSearch Dashboards against a Lucenia cluster. You'll also need a license, instructions for which can be found in this tutorial. The only setting necessary in opensearch_dashboards.yml is ignoring the node version.

opensearch_dashboards.yml:

opensearch.ignoreVersionMismatch: true
opensearch.ssl.verificationMode: none

docker-compose.yml:

services:
  lucenia-node:
    image: lucenia/lucenia:0.6.1
    container_name: lucenia-node
    environment:
      - cluster.name=lucenia-cluster
      - node.name=lucenia-node
      - discovery.type=single-node
      - bootstrap.memory_lock=true # along with the memlock settings below, disables swapping
      - "LUCENIA_JAVA_OPTS=-Xms512m -Xmx512m" # minimum and maximum Java heap size, recommend setting both to 50% of system RAM
      - LUCENIA_INITIAL_ADMIN_PASSWORD=MyStrongPassword123!
    ulimits:
      memlock:
        soft: -1
        hard: -1
      nofile:
        soft: 65536 # maximum number of open files for the Lucenia user, set to at least 65536 on modern systems
        hard: 65536
    volumes:
      - ./node/config/lucenia.yml:/usr/share/lucenia/config/lucenia.yml
      - ./node/config/trial.crt:/usr/share/lucenia/config/trial.crt
    ports:
      - 9200:9200
    networks:
      - lucenia-net
  opensearch-dashboards:
    image: opensearchproject/opensearch-dashboards:2.18.0
    container_name: opensearch-dashboards
    ports:
      - 5601:5601
      - 5603:5603
    expose:
      - "5601"
      - "5603"
    environment:
      - OPENSEARCH_HOSTS=["https://lucenia-node:9200"]
      - SERVER_HOST="0.0.0.0"
      - OPENSEARCH_USERNAME=admin
      - OPENSEARCH_PASSWORD=MyStrongPassword123!
    networks:
      - lucenia-net
    volumes:
      - ./opensearch_dashboards.yml:/usr/share/opensearch-dashboards/config/opensearch_dashboards.yml
networks:
  lucenia-net:

docker compose up