﻿---
title: Fix master nodes out of disk
description: Elasticsearch is using master nodes to coordinate the cluster. If the master or any master eligible nodes are running out of space, you need to ensure...
url: https://www.elastic.co/elastic/docs-builder/docs/2439/troubleshoot/elasticsearch/fix-master-node-out-of-disk
products:
  - Elasticsearch

This applies to:
- Generally available in 9.0+ for Stack
- Generally available for ECH
- Generally available in 3.0+ for ECK
- Generally available in 4.0+ for ECE
- Generally available in 9.0+ for Self-managed
---

# Fix master nodes out of disk
Elasticsearch is using master nodes to coordinate the cluster. If the master or any master eligible nodes are running out of space, you need to ensure that they have enough disk space to function. If the [health API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-health-report) reports that your master node is out of space you need to increase the disk capacity of your master nodes.
<applies-switch>
  <applies-item title="{ ece:, ess: }">
    <warning applies-to="Generally available in 4.0+ for ECE">
      In ECE, resizing is limited by your [allocator capacity](https://www.elastic.co/elastic/docs-builder/docs/2439/deploy-manage/deploy/cloud-enterprise/ece-manage-capacity).
    </warning>

    1. Log in to the [Elastic Cloud console](https://cloud.elastic.co?page=docs&placement=docs-body) or ECE Cloud UI.
    2. On the home page, find your deployment and select **Manage**.
    3. Go to **Actions** > **Edit deployment** and then go to the **Master instances** section:
       ![](https://www.elastic.co/elastic/docs-builder/docs/2439/troubleshoot/images/elasticsearch-reference-increase-disk-capacity-master-node.png)

    1. Choose a larger than the pre-selected capacity configuration from the drop-down menu and click **Save**. Wait for the plan to be applied and the problem should be resolved.
  </applies-item>

  <applies-item title="{ eck:, self: }">
    To increase the disk capacity of a master node, you will need to replace **all** the master nodes with master nodes of higher disk capacity.
    1. First, retrieve the disk threshold that indicates how much disk space is needed. The relevant threshold is the [high watermark](https://docs-v3-preview.elastic.dev/elastic/docs-builder/docs/2439/reference/elasticsearch/configuration-reference/cluster-level-shard-allocation-routing-settings#cluster-routing-watermark-high) and can be retrieved using the following command:
       ```json
       ```
       The response looks like this:
       ```json
       {
         "defaults": {
           "cluster": {
             "routing": {
               "allocation": {
                 "disk": {
                   "watermark": {
                     "high": "90%",
                     "high.max_headroom": "150GB"
                   }
                 }
               }
             }
           }
         }
       ```
       This response means that, to resolve the disk shortage, you need to either drop your disk usage below the 90% or have more than 150GB available. [Read more about how this threshold works](https://docs-v3-preview.elastic.dev/elastic/docs-builder/docs/2439/reference/elasticsearch/configuration-reference/cluster-level-shard-allocation-routing-settings#cluster-routing-watermark-high).
    2. The next step is to find out the current disk usage. This information allows you to calculate how much extra space is needed. In the following example, we show only the master nodes for readability purposes:
       ```json
       ```
       The response looks like this:
       ```json
       name                master node.role disk.used_percent disk.used disk.avail disk.total
       instance-0000000000 *      m                    85.31    3.4gb     500mb       4gb
       instance-0000000001 *      m                    50.02    2.1gb     1.9gb       4gb
       instance-0000000002 *      m                    50.02    1.9gb     2.1gb       4gb
       ```
    3. The goal is to reduce disk usage below the relevant threshold, in our example 90%. Consider adding some padding so that usage doesn't immediately exceed the threshold again. If you have multiple master nodes you need to ensure that **all** master nodes will have this capacity. Assuming you have the new nodes ready, follow the next three steps for every master node.
    4. Bring down one of the master nodes.
    5. Start up one of the new master nodes and wait for it to join the cluster. You can check this using the following API call:
       ```json
       ```
    6. Only after you have confirmed that your cluster has the initial number of master nodes, move forward to the next one until all the initial master nodes have been replaced.
  </applies-item>
</applies-switch>