elasticstack/elasticsearch/conf/elasticsearch.yml

   1 # ======================== Elasticsearch Configuration =========================
   2 #
   3 # NOTE: Elasticsearch comes with reasonable defaults for most settings.
   4 #       Before you set out to tweak and tune the configuration, make sure you
   5 #       understand what are you trying to accomplish and the consequences.
   6 #
   7 # The primary way of configuring a node is via this file. This template lists
   8 # the most important settings you may want to configure for a production cluster.
   9 #
  10 # Please consult the documentation for further information on configuration options:
  11 # https://www.elastic.co/guide/en/elasticsearch/reference/index.html
  12 #
  13 # ---------------------------------- Cluster -----------------------------------
  14 #
  15 # Name of the Elasticsearch cluster.
  16 # A node can only join a cluster when it shares its cluster.name with all the other nodes in the cluster.
  17 # The default name is elasticsearch, but you should change it to an appropriate name which describes the
  18 # purpose of the cluster.
  19 #
  20 cluster.name: $cluster.name
  21 #
  22 # ------------------------------------ Node ------------------------------------
  23 #
  24 # It is better to provide different meaningfull names fot different elastic nodes.
  25 # By default, Elasticsearch will take the 7 first character of the randomly generated uuid used as the node id.
  26 # Note that the node id is persisted and does not change when a node restarts
  27 #
  28 #node.name: $node.name
  29 #
  30 #
  31 # ----------------------------------- Paths ------------------------------------
  32 #
  33 # The location of the data files of each index / shard allocated on the node. Can hold multiple locations separated by coma.
  34 # In production, we should not keep this fixed, as on upgrading Elasticsearch, directory structure
  35 # may change & can deal to data loss.
  36 path.data: /usr/share/elasticsearch/data
  37 #
  38 # Elasticsearch's log files location. In production, we should not keep this default to "/elasticsearch/logs",
  39 # as on upgrading Elasticsearch, directory structure may change.
  40 path.logs: /usr/share/elasticsearch/logs
  41 #
  42 # ----------------------------------- Memory -----------------------------------
  43 #
  44 # It is vitally important to the health of your node that none of the JVM is ever swapped out to disk.
  45 # Lock the memory on startup.
  46 #
  47 bootstrap.memory_lock: true
  48 #
  49 # Make sure that the heap size is set to about half the memory available
  50 # on the system and that the owner of the process is allowed to use this
  51 # limit.
  52 #
  53 # Elasticsearch performs poorly when the system is swapping the memory.
  54 #
  55 # ---------------------------------- Network -----------------------------------
  56 # This IP is published for TCP & HTTP communications.
  57 # HTTP is used for REST communications.
  58 # TCP is used for communication between Elasticsearch cluster nodes
  59 # If you have different different IPs for TCP & HTTP, you have to declare "transport.publish_host" & "http.publish_host"
  60 # More info: https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-network.html
  61 network.publish_host: $network.publish_host
  62 #
  63 # Set the bind address to a specific IP (IPv4 or IPv6):
  64 # In order to communicate and to form a cluster with nodes on other servers, your node will need to bind to a
  65 # non-loopback address.
  66 #network.host: "0.0.0.0"
  67 #
  68 # Set a custom port for HTTP: If required, default is 9200-9300
  69 # This is used for REST APIs
  70 http.port: $http.port
  71 #
  72 # Port to bind for communication between nodes. Accepts a single value or a range.
  73 # If a range is specified, the node will bind to the first available port in the range.
  74 # Defaults to 9300-9400.
  75 # More info:
  76 transport.tcp.port: $transport.tcp.port
  77 #
  78 # For more information, consult the network module documentation.
  79 #
  80 # --------------------------------- Discovery ----------------------------------
  81 #
  82 # Pass an initial list of hosts to perform discovery when new node is started:
  83 # To form a cluster with nodes on other servers, you have to provide a seed list of other nodes in the cluster
  84 # that are likely to be live and contactable.
  85 # By default, Elasticsearch will bind to the available loopback addresses and will scan ports 9300 to 9305 to try
  86 # to connect to other nodes running on the same server.
  87 #
  88 discovery.zen.ping.unicast.hosts: $discovery.zen.ping.unicast.hosts
  89 #
  90 # This setting tells Elasticsearch to not elect a master unless there are enough master-eligible nodes
  91 # available. Only then will an election take place.
  92 # Prevent the "split brain" by configuring the majority of nodes (total number of master-eligible nodes / 2 + 1):
  93 discovery.zen.minimum_master_nodes: 2
  94 #
  95 # For more information, consult the zen discovery module documentation.
  96 #