diff --git a/docs/reference/setup/important-settings/path-settings.asciidoc b/docs/reference/setup/important-settings/path-settings.asciidoc index 55d2014701cf6..548bae035993e 100644 --- a/docs/reference/setup/important-settings/path-settings.asciidoc +++ b/docs/reference/setup/important-settings/path-settings.asciidoc @@ -12,11 +12,14 @@ subdirectories of `$ES_HOME` by default. However, files in `$ES_HOME` risk deletion during an upgrade. In production, we strongly recommend you set the `path.data` and `path.logs` in -`elasticsearch.yml` to locations outside of `$ES_HOME`. - -TIP: <>, <>, <>, <>, -and <> installations write data and log to locations -outside of `$ES_HOME` by default. +`elasticsearch.yml` to locations outside of `$ES_HOME`. <>, +<>, <>, <>, and <> installations write data and log to locations outside of `$ES_HOME` by +default. + +IMPORTANT: To avoid errors, only {es} should open files in the `path.data` +directory. Exclude the `path.data` directory from other services that may open +and lock its files, such as antivirus or backup programs. Supported `path.data` and `path.logs` values vary by platform: