oee.yaml is the policy manifest of an Executor binary. oee init scaffolds it, oee validate checks it, and oee build signs it with Ed25519 and seals it into the binary's policy segment, where nothing at run time can change it.
The runtime version: Python 3.10 to 3.13, JVM 17, 21 or 25.
workload.<adapter>.requirements
"./requirements.txt"
The Python dependencies to resolve and bundle.
workload.<adapter>.bundle_paths
["./app", "./configs"]
The application's files and directories to bundle.
workload.entrypoint
["python", "-m", "uvicorn", ...]
The exact command line that starts the service, one list item per argument. {{port}} is replaced by the replica's port, or by the port of autoscale.load_balancer.listen when auto-scaling is off.
workload.passthrough_cli_args
true
Whether arguments given to the binary pass through to the application.
workload.working_dir
"."
The working directory of the application.
sandbox
Key
Values
Meaning
sandbox.enabled
true, false
Turns the isolation boundary on or off. With false, the application runs on the host with standard user permissions, still under supervision, caps and exit events.
sandbox.container_fallback
"auto" (default), "strict"
Inside a container: layer the unprivileged primitives that are available, or refuse to start (exit code 69) when a requested namespace primitive is not.
sandbox.syscall_profile
"strict", "runtime-managed", "custom"
The system-call filter. strict is the default for Go and Rust static binaries; runtime-managed is selected for Python, JVM and Node.js.
sandbox.filesystem.read_only_paths
List of paths
Host paths or workspace folders the guest may read.
sandbox.filesystem.read_write_paths
List of paths
Paths the guest may change. Files written there persist after a stop.
sandbox.network.inbound_allow_ports
List of ports, such as [8000]
Ports the guest may accept connections on. With auto-scaling, it governs the public load-balancer port only.
sandbox.network.outbound_allow
true, false
Whether the guest may open outbound connections.
sandbox.network.outbound_allow_cidrs
List of CIDRs
Where outbound connections may go.
Sandboxing explains each dimension on Linux, Windows and macOS.
resources
Key
Values
Meaning
resources.cpu.limit
"10%", "1vcpu", "0.5vcpu", "2"
A share of the machine's logical CPUs, or an absolute number of cores.
resources.cpu.mode
"strict" (default), "flexible"
A hard ceiling, or a proportional share with optional bursting.
resources.cpu.burst_limit
A CPU quantity
In flexible mode, the hard ceiling of bursting.
resources.memory.limit
"10%", "10GB", "512MB", "2GiB"
A share of the machine's physical memory, or an absolute amount.
resources.memory.mode
"strict" (default), "flexible"
A hard ceiling that is never exceeded, or a soft target the kernel reclaims toward.
resources.memory.burst_limit
A memory quantity
In flexible mode, the hard ceiling.
resources.max_pids
64
The most processes the tree may hold.
resources.max_open_files
4096
The file descriptors per process.
resources.allow_governor_fallback
false (default), true
On Linux without a kernel hard limit: refuse to start a strict cap (exit code 69), or enforce it with the supervisor governor.
One or more pinned SHA-256 Subject Public Key Info hashes.
tls.enabled
true
For message sources: connect over TLS.
stop_when
Key
Meaning
stop_when.match
"ANY" or "ALL" of the conditions.
stop_when.conditions
A list of conditions: json_path with in or equals; body_exact; a substring or a regular expression; http_status; a response header; exit_code, stdout_contains or stdout_regex for commands.
on_network_error
Key
Values
Meaning
on_network_error.mode
"FAIL_OPEN" (default), "FAIL_CLOSED"
Keep running through outages, or treat a lost lease as a stop.
on_network_error.max_consecutive_failures
Such as 5
With FAIL_CLOSED, how many polls may fail in a row before the stop.
Exit events explains every rule type with examples.
Validation
oee validate -f oee.yaml --strict checks the syntax, sandbox path permissions, cron expressions, JSONPath queries and environment variable references. The guided oee init --interactive validates every answer with the same rules.