Doc: executor manager updated docker version (#11946)

### What problem does this PR solve?

Add documentation for #11806.

### Type of change

- [x] Documentation Update
This commit is contained in:
Yongteng Lei
2025-12-15 11:13:51 +08:00
committed by GitHub
parent 1ddd11f045
commit 13d8241eee
3 changed files with 45 additions and 3 deletions

View File

@ -23,6 +23,10 @@ We use gVisor to isolate code execution from the host system. Please follow [the
RAGFlow Sandbox is a secure, pluggable code execution backend. It serves as the code executor for the **Code** component. Please follow the [instructions here](https://github.com/infiniflow/ragflow/tree/main/sandbox) to install RAGFlow Sandbox.
:::note Docker client version
The executor manager image now bundles Docker CLI `29.1.0` (API 1.44+). Older images shipped Docker 24.x and will fail against newer Docker daemons with `client version 1.43 is too old`. Pull the latest `infiniflow/sandbox-executor-manager:latest` or rebuild `./sandbox/executor_manager` if you encounter this error.
:::
:::tip NOTE
If your RAGFlow Sandbox is not working, please be sure to consult the [Troubleshooting](#troubleshooting) section in this document. We assure you that it addresses 99.99% of the issues!
:::
@ -122,6 +126,22 @@ docker pull infiniflow/sandbox-base-nodejs:latest
docker pull infiniflow/sandbox-base-python:latest
```
### `docker: Error response from daemon: client version 1.43 is too old. Minimum supported API version is 1.44`
**Root cause**
The executor manager image you are running includes Docker CLI 24.x (API 1.43) while the host Docker daemon now requires API 1.44+ (e.g., Docker 25+ / 29.x).
**Solution**
Pull the refreshed image or rebuild locally so the embedded Docker client is new enough:
```bash
docker pull infiniflow/sandbox-executor-manager:latest
# or
docker build -t sandbox-executor-manager:latest ./sandbox/executor_manager
```
### `HTTPConnectionPool(host='none', port=9385): Max retries exceeded.`
**Root cause**