Skip to content

docs: add Docker ESP32 troubleshooting section#214

Open
Jah-yee wants to merge 1 commit into
ruvnet:mainfrom
Jah-yee:main
Open

docs: add Docker ESP32 troubleshooting section#214
Jah-yee wants to merge 1 commit into
ruvnet:mainfrom
Jah-yee:main

Conversation

@Jah-yee
Copy link
Copy Markdown

@Jah-yee Jah-yee commented Mar 10, 2026

Description

Adds a troubleshooting section to address issue #213 where users encounter /bin/sh: 0: Illegal option -- error when trying to pass --source esp32 argument to the Docker container.

Changes

  • Added troubleshooting section explaining correct Docker usage for ESP32 source
  • Documented environment variable approach (-e WIFI_SOURCE=esp32)
  • Referenced docker-compose as alternative

Related Issue

Fixes #213

- Add troubleshooting section for Docker ESP32 source issue
- Fixes issue ruvnet#213: /bin/sh: 0: Illegal option -- error
- Document correct environment variable usage for ESP32 source
@ruvnet
Copy link
Copy Markdown
Owner

ruvnet commented May 17, 2026

Heads-up: the env-var name in the diff is WIFI_SOURCE but docker/docker-compose.yml:20 and the entrypoint use CSI_SOURCE (CSI_SOURCE=${CSI_SOURCE:-auto}). Could you update the README snippet to -e CSI_SOURCE=esp32 so the documented command actually works? Otherwise the diff is helpful — once that's fixed, merging.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

I can't use the docker to run esp32

2 participants