ArangoDB Server environment variables

arangod inspects the following list of environment variables:

• ARANGODB_OVERRIDE_DETECTED_TOTAL_MEMORY

  This variable can be used to override the automatic detection of the total amount of RAM present on the system. One can specify a decimal number (in bytes). Furthermore, if G or g is appended, the value is multiplied by 2^30. If M or m is appended, the value is multiplied by 2^20. If K or k is appended, the value is multiplied by 2^10. That is, 64G means 64 gigabytes.

  The total amount of RAM detected is logged as an INFO message at server start. If the variable is set, the overridden value is shown. Various default sizes are calculated based on this value (e.g. RocksDB buffer cache size).

  Setting this option can in particular be useful in two cases:

  1. If arangod is running in a container and its cgroup has a RAM limitation, then one should specify this limitation in this environment variable, since it is currently not automatically detected.
  2. If arangod is running alongside other services on the same machine and thus sharing the RAM with them, one should limit the amount of memory using this environment variable.

• ARANGODB_OVERRIDE_DETECTED_NUMBER_OF_CORES (introduced in v3.7.1)

  This variable can be used to override the automatic detection of the number of CPU cores present on the system.

  The number of CPU cores detected is logged as an INFO message at server start. If the variable is set, the overridden value is shown. Various default values for threading are calculated based on this value.

  Setting this option is useful if arangod is running in a container or alongside other services on the same machine and shall not use all available CPUs.

• ARANGODB_OVERRIDE_CRASH_HANDLER (introduced in v3.7.1)

  This variable can be used to toggle the built-in crash handler in the Linux builds of arangod. The crash handler is turned on by default for Linux builds, and it can be turned off by setting this environment variable to an empty string, the value of 0 or off.

• CACHE_OBLIVIOUS (introduced in v3.9.7, v3.10.3)

  If set to the string true, jemalloc allocates one additional page (4096 bytes) for every allocation of 16384 or more bytes to change the base address if it is not divisible by 4096. This can help the CPU caches if the beginning of such blocks are accessed a lot.

  On the other hand, it increases the memory usage because of the page alignment. The RocksDB buffer cache does most of its allocations for 16384 bytes, increasing the RAM usage by 25%. Setting the option to false disables the optimization but the performance is expected to be the same for ArangoDB.

  The default is true in 3.9.

  Also see the jemalloc documentation.

• TZ_DATA (introduced in v3.8.0)

  This variable can be used to specify the path to the directory containing the timezone information database for ArangoDB. That directory is normally named tzdata and is shipped with ArangoDB releases. It is normally not required to set this environment variable, but it may be necessary in unusual setups with non-conventional directory layouts and paths.

• IRESEARCH_TEXT_STOPWORD_PATH

  Path to a directory with stopword files for ArangoSearch Text Analyzers.

For Docker specific environment variables please refer to Docker Hub