Base images

Every template starts from one base image. Select it first, then add packages, files, and commands.

AgentBox base image

fromBaseImage() uses AgentBox's pinned base OCI image. It is a practical default for Python, Node.js, Git, and command-line workloads.

Common OCI images

The SDK provides helpers for common images: fromUbuntuImage, fromDebianImage, fromFedoraImage, fromAlpineImage, fromArchImage, fromPythonImage, fromNodeImage, and fromBunImage.

For example:

• fromUbuntuImage("24.04") selects ubuntu:24.04;
• fromNodeImage("24-bookworm-slim") selects node:24-bookworm-slim;
• fromBunImage("1.3") selects oven/bun:1.3.

These are OCI images from a Docker Registry. AgentBox uses their filesystem as the template foundation, but runs the sandbox in a virtual machine rather than in a Docker container.

Any OCI image

fromImage("registry.example.com/team/app:1.4.0") accepts a complete OCI image reference. For a private registry, supply its credentials.

A definition can select only one base. Use fromTemplate("name:tag") to extend one of your existing templates.