From 2ed793a1e03f9527d84adc807694dc7f6464c5c3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?=
 <47506558+MegaRedHand@users.noreply.github.com>
Date: Fri, 13 Feb 2026 16:10:36 -0300
Subject: [PATCH] docs: add Docker Desktop on macOS solution

---
 README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/README.md b/README.md
index 118a821..85ee07f 100644
--- a/README.md
+++ b/README.md
@@ -493,6 +493,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: