Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

fix(docker): bind server to 0.0.0.0 so Docker port-mapping works (#1803)

Zayn Jarvis536747b53f17
diff --git a/docker/openviking-console-entrypoint.sh b/docker/openviking-console-entrypoint.sh
index 20bf92a78..3afa3a0f8 100644
--- a/docker/openviking-console-entrypoint.sh
+++ b/docker/openviking-console-entrypoint.sh
@@ -106,10 +106,12 @@ forward_signal() {
trap 'forward_signal' INT TERM
+SERVER_HOST="${OPENVIKING_SERVER_HOST:-0.0.0.0}"
+
if [ "${WITH_BOT}" = "1" ]; then
- openviking-server --with-bot &
+ openviking-server --host "${SERVER_HOST}" --with-bot &
else
- openviking-server &
+ openviking-server --host "${SERVER_HOST}" &
fi
SERVER_PID=$!
diff --git a/docs/en/guides/03-deployment.md b/docs/en/guides/03-deployment.md
index adecded0c..1ca447478 100644
--- a/docs/en/guides/03-deployment.md
+++ b/docs/en/guides/03-deployment.md
@@ -197,10 +197,22 @@ docker run -d \
```
By default, the Docker image starts:
-- OpenViking HTTP service on port `1933`
+- OpenViking HTTP service on port `1933` (bound to `0.0.0.0`)
- OpenViking Console on port `8020`
- `vikingbot` gateway
+Since the server binds to `0.0.0.0` inside the container (required for Docker port-mapping to work), you **must** set `root_api_key` in your `ov.conf`:
+
+```json
+{
+ "server": {
+ "root_api_key": "your-secret-root-key"
+ }
+}
+```
+
+The server will refuse to start without it. You can override the bind address via the `OPENVIKING_SERVER_HOST` environment variable if needed.
+
Upgrade the container:
```bash
docker stop openviking
diff --git a/docs/zh/guides/03-deployment.md b/docs/zh/guides/03-deployment.md
index 9e0a0de09..79c5a8cfb 100644
--- a/docs/zh/guides/03-deployment.md
+++ b/docs/zh/guides/03-deployment.md
@@ -195,10 +195,22 @@ docker run -d \
```
Docker 镜像默认会同时启动:
-- OpenViking HTTP 服务,端口 `1933`
+- OpenViking HTTP 服务,端口 `1933`(绑定 `0.0.0.0`)
- OpenViking Console,端口 `8020`
- `vikingbot` gateway
+由于容器内服务绑定 `0.0.0.0`(Docker 端口映射所必需),你**必须**在 `ov.conf` 中设置 `root_api_key`:
+
+```json
+{
+ "server": {
+ "root_api_key": "your-secret-root-key"
+ }
+}
+```
+
+未设置时服务将拒绝启动。如需自定义绑定地址,可通过环境变量 `OPENVIKING_SERVER_HOST` 覆盖。
+
升级容器的方式
```bash
docker stop openviking