its-consulting/ralph-claude-code
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(docker): add troubleshooting for "docker daemon not running" error

Browse source 
Add prerequisite note that Docker Desktop must be running, and add
troubleshooting entry for the most common Windows error with
platform-specific instructions to start the Docker daemon.

https://claude.ai/code/session_01SNzxUdH1Udf26rN3RKNNzu
This commit is contained in:
Claude 2026-02-10 21:04:18 +00:00
parent c01133bd8d
commit b17b1a39bf
No known key found for this signature in database
1 changed files with 5 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

5
docs/user-guide/04-docker-setup.md
View file

@ -6,6 +6,7 @@ Ralph runs natively on Linux and macOS. For **Windows** users (or anyone who pre
- [Docker Desktop](https://www.docker.com/products/docker-desktop/) (Windows/macOS) or Docker Engine (Linux)
- Windows users: Docker Desktop must use the **WSL 2 backend** (default on modern installations)
- **Docker Desktop must be running** before executing any `docker` commands. Look for the Docker whale icon in your system tray (Windows) or menu bar (macOS).
- Your `ANTHROPIC_API_KEY`
## Quick Start
@ -157,6 +158,10 @@ $env:ANTHROPIC_API_KEY = "sk-ant-..."
## Troubleshooting
### "error during connect: docker daemon is not running"
Docker Desktop is not started. On Windows, launch Docker Desktop from the Start menu and wait until the whale icon in the system tray shows "Docker Desktop is running". On macOS, launch it from Applications. On Linux, start the daemon with `sudo systemctl start docker`.
### "ANTHROPIC_API_KEY is not set"
The container warns if no API key is provided. Pass it with `-e ANTHROPIC_API_KEY=...`.