Skip to content

πŸ™Œ OpenHands: AI-Driven Development

fix: use versioned release tags for agent-server Docker images (#338)

Rohit Malhotrac0bc27c0caa8
diff --git a/AGENTS.md b/AGENTS.md
index 99a3f1e055..6650696082 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -103,6 +103,11 @@
- `OH_SECRET_KEY` β€” secret key for settings encryption; uses a static default for local dev since it's needed for reading persisted encrypted values across restarts
- `SESSION_API_KEY` / `OH_SESSION_API_KEYS_0` / `VITE_SESSION_API_KEY` β€” session API key for agent-server authentication; auto-generated using `crypto.randomBytes(32)` if not set, passed to both agent-server (`OH_SESSION_API_KEYS_0`) and frontend (`VITE_SESSION_API_KEY`)
- Default: released PyPI version `1.22.0` for agent-server SDK libraries
+- `scripts/dev-docker.mjs` runs the agent-server inside a Docker container instead of via `uvx`. The default image uses versioned release tags:
+ - `DEFAULT_AGENT_SERVER_TAG` β€” uses format `v{version}-python` (e.g., `v1.22.0-python`) for reproducibility
+ - Should stay in sync with `DEFAULT_AGENT_SERVER_VERSION` in `dev-safe.mjs` for consistency between Docker and non-Docker dev modes
+ - `OH_AGENT_SERVER_GIT_REF` β€” override to use a git ref-based tag (e.g., `main` β†’ `main-python`, `abc1234` β†’ `abc1234-python`)
+ - Docker images are published from https://github.com/OpenHands/software-agent-sdk via the Agent Server workflow to `ghcr.io/openhands/agent-server`
- Security: Both `scripts/dev-safe.mjs` and `scripts/dev-with-automation.mjs` auto-generate random API keys on each startup for better security isolation:
- `SESSION_API_KEY` β€” 64-character hex (256-bit) for agent-server API authentication; auto-generated per session unless overridden via env var
- `AUTOMATION_LOCAL_API_KEY` β€” 64-character hex for automation backend auth; auto-generated per session unless overridden
diff --git a/scripts/dev-docker.mjs b/scripts/dev-docker.mjs
index 96179f317f..dc0ec35850 100644
--- a/scripts/dev-docker.mjs
+++ b/scripts/dev-docker.mjs
@@ -68,8 +68,10 @@ const CONTAINER_LOCAL_SDK_DIR = "/agent-server-src";
// Docker image for the agent-server.
const AGENT_SERVER_REPO = "ghcr.io/openhands/agent-server";
-// Default tag used when OH_AGENT_SERVER_GIT_REF is not set. Update to upgrade.
-const DEFAULT_AGENT_SERVER_TAG = "0924962-python";
+// Default tag used when OH_AGENT_SERVER_GIT_REF is not set.
+// Should match DEFAULT_AGENT_SERVER_VERSION in dev-safe.mjs for consistency.
+// Format: v{version}-python (e.g., v1.22.0-python) for released versions.
+const DEFAULT_AGENT_SERVER_TAG = "v1.22.0-python";
const CONTAINER_NAME = "agent-canvas-dev-agent-server";
// Default secret key matches dev-safe.mjs so persisted settings stay