Important settings

For production workloads, make sure the Linux setting vm.max_map_count is set to at least 262144. Even if you use the Docker image, set this value on the host machine. To check the current value, run this command:

  1. cat /proc/sys/vm/max_map_count

To increase the value, add the following line to /etc/sysctl.conf:

  1. vm.max_map_count=262144

Then run sudo sysctl -p to reload.

The sample docker-compose.yml file also contains several key settings:

  • bootstrap.memory_lock=true

    Disables swapping (along with memlock). Swapping can dramatically decrease performance and stability, so you should ensure it is disabled on production clusters.

  • OPENSEARCH_JAVA_OPTS=-Xms512m -Xmx512m

    Sets the size of the Java heap (we recommend half of system RAM).

  • nofile 65536

    Sets a limit of 65536 open files for the OpenSearch user.

  • port 9600

    Allows you to access Performance Analyzer on port 9600.

Network requirements

The following ports need to be open for OpenSearch components.

Port numberOpenSearch component
443OpenSearch Dashboards in AWS OpenSearch Service with encryption in transit (TLS)
5601OpenSearch Dashboards
9200OpenSearch REST API
9250Cross-cluster search
9300Node communication and transport
9600Performance Analyzer