# WeKnora Sandbox Image # Pre-built environment for executing agent skill scripts in Docker sandbox # Multi-stage build, minimal dependencies # # Two targets ship from this file: # runtime (default) - the plain environment. Used by the Docker backend and # as the base image of E2B templates, whose builder # injects its own envd. # cube - the same environment plus Cube's envd daemon. Cube # builds templates straight from the image and probes # :49983/health, so an image without envd can only ever # fail. See docs/sandbox-cluster.md. # Stage 1: Get Node.js binaries FROM node:20-slim AS node-base # Stage 2: Runtime image FROM python:3.11-slim AS runtime # Copy Node.js from node image (avoids NodeSource install overhead) COPY --from=node-base /usr/local/bin/node /usr/local/bin/ COPY --from=node-base /usr/local/lib/node_modules /usr/local/lib/node_modules RUN ln -s /usr/local/lib/node_modules/npm/bin/npm-cli.js /usr/local/bin/npm && \ ln -s /usr/local/lib/node_modules/npm/bin/npx-cli.js /usr/local/bin/npx # Python package manager: uv (fast pip replacement). Preinstalled because each # skill gets its own venv at install time, and building that from a cold pip is # what dominates an install's wall clock. COPY --from=ghcr.io/astral-sh/uv:0.12.4 /uv /usr/local/bin/uv RUN ln -s /usr/local/bin/uv /usr/local/bin/uvx # Node package manager: pnpm RUN npm install -g pnpm # Install minimal CLI tools (bash/grep/sed/coreutils/findutils already in slim # image). `file` is not in slim; models reach for it after a script-type error. # curl is not optional: the sandbox connectivity check probes egress with it, # and skills that fetch a URL expect it to be there. The compression tools are # here because skill bundles and their assets arrive archived. RUN apt-get update && apt-get install -y --no-install-recommends \ jq \ curl \ ca-certificates \ file \ zip \ unzip \ bzip2 \ xz-utils \ zstd \ && rm -rf /var/lib/apt/lists/* /var/cache/apt/* # Add packages here when installed skills actually need them: # Sandbox scripts run as root by default: each chat session owns its own # sandbox, so the in-container account is not a tenant boundary, and agents are # expected to install packages and write wherever they need. A non-root # "user" account (UID 1000) is still created and named for interop — E2B # templates expose it and some tooling still addresses it by name — and it # gives something for `sudo` and E2B/Cube requests that target a named account # to land on. The Docker backend can also address it numerically as 1000:1000. RUN groupadd -g 1000 user && \ useradd -u 1000 -g user -m -s /bin/bash user # Pre-create the two directories every backend writes to. Root can create them # at exec time too. Ownership stays with the compatibility account so tools # explicitly selecting user can also write here; default root execs do not # rely on that ownership. RUN mkdir -p /workspace/input /workspace/output && \ chown -R user:user /workspace WORKDIR /workspace USER root # Stage 3: Cube template image # # envd is what Cube talks to for everything — the readiness probe that decides # whether a template build succeeds, plus every later exec and file call. It # runs as root and selects the account named in each request. WeKnora names # root by default, matching the runtime stage. # # This target is linux/amd64 only: cubesandbox-base publishes no arm64 image, # which matches Cube itself (PVM is x86_64-only). FROM ghcr.io/tencentcloud/cubesandbox-base:2026.16 AS cube-base FROM runtime AS cube USER root COPY --from=cube-base /usr/bin/envd /usr/bin/envd COPY --from=cube-base /usr/local/bin/cube-entrypoint.sh /usr/local/bin/cube-entrypoint.sh EXPOSE 49983 # The entrypoint backgrounds envd and then waits on it, since this image # defines no CMD of its own. ENTRYPOINT ["/usr/local/bin/cube-entrypoint.sh"] # Stage 4: default target # # Docker builds the last stage when none is named, and that must stay the plain # runtime: a bare `docker build -f docker/Dockerfile.sandbox .` is expected to # produce the image the Docker backend runs, not the Cube variant. FROM runtime AS sandbox