// troubleshooting guide · opensearch

OpenSearch Cluster Status Yellow

Status
Workaround available
platforms:
Self-hosted, Amazon OpenSearch Service
updated:
November 15, 2026
reports:
3
Method
how we research
Share

RUNBOOK · opensearch/cluster-status-yellow4 FIXES

// quick answer

Yellow means all primaries are assigned but at least one replica is not. A single node is always yellow; on multiple nodes check disk space and replica counts.

Most likely fix: Check why replicas are unassigned

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Check why replicas are unassigned

    1. 01GET _cat/shards?v and look for UNASSIGNED rows with prirep r
    2. 02GET _cluster/allocation/explain
    Did this fix it?
  2. FIX 2Single-node cluster

    1. 01Add a second node, or
    2. 02Set replicas to 0 for dev: PUT my-index/_settings {"index":{"number_of_replicas":0}}
    Did this fix it?
  3. FIX 3Free disk space

    1. 01GET _cat/allocation?v to see disk usage per node
    2. 02Delete old indices or add storage
    Did this fix it?
  4. FIX 4Wait if it is transient

    1. 01After a restart or new index the cluster often self-heals as replicas copy
    Did this fix it?

Symptoms

Health is yellow; data is searchable but has no redundancy for some indices.

Why it happens

  • C-01Single-node cluster with number_of_replicas of 1 or more
  • C-02Not enough nodes for the replica count
  • C-03Low disk space blocking replica placement
  • C-04Temporary state after node restart or new index

// this guide also covers

  • opensearch cluster yellow
  • opensearch yellow status single node
  • opensearch replica unassigned

Still not working?

If OpenSearch keeps failing, you're not alone. See every OpenSearch problem users report or the alternatives people switch to.

Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.

Talk to us

Watch OpenSearch Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other OpenSearch errors

All 11 OpenSearch errors and fixes →