Skip to content
OpenRelay is in early access, and the /v1 API is stable. New capabilities ship in the changelog.
Skip to Content
CLICommands

orl sandbox create

Create a sandbox, optionally running a first command, part of the orl CLI for OpenRelay GPU VMs, pods, batches and billing.

orl sandbox create --template <template>

Flags

FlagTypeRequired
--cpuintnovCPUs, at most the template's (the template's unless given)
--cpu-requestfloat64novCPUs a shared sandbox is counted and billed for at least, to the thousandth (0.25 unless given)
--envstringSlicenoNAME=VALUE (repeatable)
--ephemeralboolnoomit the sandbox from history when it ends; a command finishing does not stop it
--idempotency-keystringnomakes a retried create safe; one is made when not given
--memory-mibintnomemory in MiB, at most the template's (the template's unless given)
--memory-request-mibintnomemory in MiB a shared sandbox is counted and billed for at least (128 unless given)
--modelstringnothe model the template's coding agent (Claude Code) calls, an id from orl catalog model list; sets OPENRELAY_MODEL
--network-filestringnoa JSON file holding the sandbox's network policy layer; the organization's defaults apply when not given
--placementstringnoshared or pinned
--runstringnoa first command to run in the same request; its output streams and its exit code is this command's
--templatestringyesa template id from orl sandbox template list: a built-in or one of the org's (required)
--timeoutintnoseconds until the sandbox stops
--waitintnoseconds the request may wait for capacity

This wraps the createSandbox API operation.

On this page