WARNING: Version 2.3 of Elasticsearch has passed its EOL date.

This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.

« Running as a Service on Windows Repositories »

› ›

Directory Layout

edit

Directory Layout

edit

The directory layout of an installation is as follows:

Type	Description	Default Location	Setting
home	Home of elasticsearch installation.		`path.home`
bin	Binary scripts including `elasticsearch` to start a node.	`{path.home}/bin`
conf	Configuration files including `elasticsearch.yml`	`{path.home}/config`	`path.conf`
data	The location of the data files of each index / shard allocated on the node. Can hold multiple locations.	`{path.home}/data`	`path.data`
logs	Log files location.	`{path.home}/logs`	`path.logs`
plugins	Plugin files location. Each plugin will be contained in a subdirectory.	`{path.home}/plugins`	`path.plugins`
repo	Shared file system repository locations. Can hold multiple locations. A file system repository can be placed in to any subdirectory of any directory specified here.	Not configured	`path.repo`
script	Location of script files.	`{path.conf}/scripts`	`path.scripts`

Multiple data paths may be specified, in order to spread data across multiple disks or locations, but all of the files from a single shard will be written to the same path. This can be configured as follows:

---------------------------------
path.data: /mnt/first,/mnt/second
---------------------------------

Or in an array format:

----------------------------------------
path.data: ["/mnt/first", "/mnt/second"]
----------------------------------------

To stripe shards across multiple disks, please use a RAID driver instead.

Default Paths

edit

Below are the default paths that elasticsearch will use, if not explicitly changed.

deb and rpm

edit

Type	Description	Location Debian/Ubuntu	Location RHEL/CentOS
home	Home of elasticsearch installation.	`/usr/share/elasticsearch`	`/usr/share/elasticsearch`
bin	Binary scripts including `elasticsearch` to start a node.	`/usr/share/elasticsearch/bin`	`/usr/share/elasticsearch/bin`
conf	Configuration files `elasticsearch.yml` and `logging.yml`.	`/etc/elasticsearch`	`/etc/elasticsearch`
conf	Environment variables including heap size, file descriptors.	`/etc/default/elasticsearch`	`/etc/sysconfig/elasticsearch`
data	The location of the data files of each index / shard allocated on the node.	`/var/lib/elasticsearch/data`	`/var/lib/elasticsearch`
logs	Log files location	`/var/log/elasticsearch`	`/var/log/elasticsearch`
plugins	Plugin files location. Each plugin will be contained in a subdirectory.	`/usr/share/elasticsearch/plugins`	`/usr/share/elasticsearch/plugins`
repo	Shared file system repository locations.	Not configured	Not configured
script	Location of script files.	`/etc/elasticsearch/scripts`	`/etc/elasticsearch/scripts`

zip and tar.gz

edit

Type	Description	Location
home	Home of elasticsearch installation	`{extract.path}`
bin	Binary scripts including `elasticsearch` to start a node	`{extract.path}/bin`
conf	Configuration files `elasticsearch.yml` and `logging.yml`	`{extract.path}/config`
data	The location of the data files of each index / shard allocated on the node	`{extract.path}/data`
logs	Log files location	`{extract.path}/logs`
plugins	Plugin files location. Each plugin will be contained in a subdirectory	`{extract.path}/plugins`
repo	Shared file system repository locations.	Not configured
script	Location of script files.	`{extract.path}/config/scripts`

« Running as a Service on Windows Repositories »