---
title: stack es cluster get-settings cli command
description: Get cluster-wide settings. Behaviour flags: --dry-run — validate all inputs and exit without performing any action 
url: https://www.elastic.co/elastic/docs-builder/docs/4116/reference/elastic-cli/cli/stack/es/cluster/get-settings
applies_to:
  - Elastic Cloud Serverless: Preview
  - Elastic Stack: Preview
---

# stack es cluster get-settings cli command
<cli-modifiers>
</cli-modifiers>

```bash
elastic stack es cluster get-settings [options]
```

Get cluster-wide settings.
**Behaviour flags:**
`--dry-run` — validate all inputs and exit without performing any action

## Options

<definitions>
  <definition term="--flat-settings">
    If `true`, returns settings in flat format.
  </definition>
  <definition term="--include-defaults">
    If `true`, also returns the values of all other cluster settings set in the
    `elasticsearch.yml` file on one of the nodes in your cluster, together with the default
    values of all other cluster settings on that node. The default value of each setting may
    depend on the values of other settings on that node. If the nodes in your cluster do not all
    have the same configuration then the values returned by this API may vary from invocation to
    invocation and may not reflect the values that Elasticsearch uses in all situations. Use the
    `GET _nodes/settings` API to fetch the settings for each individual node in your cluster.
  </definition>
  <definition term="--master-timeout string">
    Period to wait for a connection to the master node.
    If no response is received before the timeout expires, the request fails and returns an error.
  </definition>
  <definition term="--timeout string">
    Period to wait for a response.
    If no response is received before the timeout expires, the request fails and returns an error.
  </definition>
  <definition term="--error-trace">
    When set to `true` Elasticsearch will include the full stack trace of errors
    when they occur.
  </definition>
  <definition term="--filter-path string">
    Comma-separated list of filters in dot notation which reduce the response
    returned by Elasticsearch.
    **Repeatable:** pass `--filter-path` multiple times to supply more than one value
  </definition>
  <definition term="--human">
    When set to `true` will return statistics in a format suitable for humans.
    For example `"exists_time": "1h"` for humans and
    `"exists_time_in_millis": 3600000` for computers. When disabled the human
    readable values will be omitted. This makes sense for responses being consumed
    only by machines.
  </definition>
  <definition term="--pretty">
    If set to `true` the returned JSON will be "pretty-formatted". Only use
    this option for debugging only.
  </definition>
  <definition term="--input-file string">
    path to a JSON file to use as command input
  </definition>
  <definition term="--dry-run">
    validate all inputs and exit without performing any action (preview changes without applying them)
  </definition>
</definitions>


## Global Options

<definitions>
  <definition term="--json">
    output as JSON
  </definition>
</definitions>