// 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
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
FIX 1Check why replicas are unassigned
- 01GET _cat/shards?v and look for UNASSIGNED rows with prirep r
- 02GET _cluster/allocation/explain
Did this fix it?FIX 2Single-node cluster
- 01Add a second node, or
- 02Set replicas to 0 for dev: PUT my-index/_settings {"index":{"number_of_replicas":0}}
Did this fix it?FIX 3Free disk space
- 01GET _cat/allocation?v to see disk usage per node
- 02Delete old indices or add storage
Did this fix it?FIX 4Wait if it is transient
- 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 usOther OpenSearch errors
- OpenSearch Cluster Status Red
- OpenSearch Unassigned Shards
- OpenSearch High JVM Memory Pressure
- OpenSearch OutOfMemoryError and Circuit Breaker
- OpenSearch Exceeded Maximum Shard Limit
- OpenSearch Index Read-Only: Disk Watermark and ClusterBlockException
- OpenSearch 429 Too Many Requests
- OpenSearch Docker Container Won't Start