Debug Elasticsearch errors

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and MacOS) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). On OS X VMs, the installation directory is /opt/bitnami and OS X VM users can click the “Open Terminal” button to run commands. Learn more about the Bitnami stack environment and about OS X VMs.

Locate the log file

The Elasticsearch log file is created at installdir/elasticsearch/logs/elasticsearch.log.

Troubleshoot startup errors

Elasticsearch has strict kernel requirements. You may find the issues below when starting Elasticsearch service:

ERROR: bootstrap checks failed
max file descriptors [XXX] for elasticsearch process is too low, increase to at least [65536]
max virtual memory areas vm.max_map_count [XXX] is too low, increase to at least [262144]

To avoid them, we strongly recommend you to apply these changes before installing:

  • Update the /etc/security/limits.conf file and add the lines below:

    * soft nofile 65536
    * hard nofile 65536
  • Update the /etc/sysctl.conf file and add this line below:

  • Reboot your system

Last modification September 6, 2018