This version of the OpenSearch documentation is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.

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:

cat /proc/sys/vm/max_map_count

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

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.