diff --git a/README.md b/README.md
index dace634..450ce62 100644
--- a/README.md
+++ b/README.md
@@ -531,6 +531,21 @@ NETWORK_DIR=local-devnet ./spin-node.sh --node all --generateGenesis --forceKeyG
 ./generate-genesis.sh local-devnet/genesis --forceKeyGen
 ```
 
+---
+
+**Problem**: Grafana dashboards show "No data"
+
+On macOS, this is typically caused by Docker's **host network mode** (`--network host`) not working out of the box. lean-quickstart uses host networking so Prometheus can scrape node metrics endpoints on `localhost`. Without host networking enabled in Docker Desktop, Prometheus cannot reach the node metrics ports, resulting in empty dashboards.
+
+**Solution**: Enable the "Enable host networking" option in Docker Desktop:
+
+1. Open **Docker Desktop** → **Settings** (gear icon)
+2. Go to **Resources** → **Network**
+3. Enable **"Enable host networking"**
+4. Click **Apply & Restart**
+
+For more details, see the [Docker Desktop host networking documentation](https://docs.docker.com/engine/network/drivers/host/#docker-desktop).
+
 ## Automation Features
 
 This quickstart includes automated configuration parsing: