elasticsearch/docs/reference/setup/dir-layout.asciidoc

[[setup-dir-layout]]
== Directory Layout

The directory layout of an installation is as follows:

[cols="<h,<,<m,<m",options="header",]
|=======================================================================
| 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. | empty | path.repo

|=======================================================================

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"]
    ----------------------------------------

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

[float]
[[default-paths]]
=== Default Paths

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

[float]
==== deb and rpm
[cols="<h,<,<m,<m",options="header",]
|=======================================================================
| 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/elasticseach | /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
|=======================================================================

[float]
==== zip and tar.gz
[cols="<h,<,<m",options="header",]
|=======================================================================
| 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

| conf | Environment variables including heap size, file descriptors | {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
|=======================================================================