From 6e6e2d0aa21c9ebd747c950365c6aa6a96fc97c2 Mon Sep 17 00:00:00 2001
From: SparkLabScout <sparklab@openclaw.ai>
Date: Tue, 10 Mar 2026 12:52:49 +0800
Subject: [PATCH] docs: add Docker ESP32 troubleshooting section

- Add troubleshooting section for Docker ESP32 source issue
- Fixes issue #213: /bin/sh: 0: Illegal option -- error
- Document correct environment variable usage for ESP32 source
---
 README.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/README.md b/README.md
index 0afdaa64..5d5a9c85 100644
--- a/README.md
+++ b/README.md
@@ -1783,6 +1783,27 @@ POSE_CONFIDENCE_THRESHOLD=0.7    # Minimum confidence
 POSE_MAX_PERSONS=10              # Max tracked individuals
 ```
 
+### Troubleshooting
+
+#### Docker with ESP32 Source
+
+If you encounter `/bin/sh: 0: Illegal option --` when running Docker with ESP32 source:
+
+```bash
+# ❌ Wrong - passing arguments after the image name
+docker run -p 3000:3000 -p 5005:5005/udp ruvnet/wifi-densepose:latest --source esp32
+
+# ✅ Correct - use environment variables or docker-compose
+docker run -p 3000:3000 -p 5005:5005/udp \
+  -e WIFI_SOURCE=esp32 \
+  ruvnet/wifi-densepose:latest
+
+# Or use docker-compose with ESP32 configuration
+cd docker && docker compose up esp32
+```
+
+The Docker container's entrypoint doesn't accept command-line arguments. Use environment variables or modify the `docker-compose.yml` file for ESP32 source configuration.
+
 </details>
 
 ---