Skip to main content
The banner shows the boxd.sh and Omnara logos with the line durable agents on machines that sleep between turns. Omnara is an open-source platform for running managed agents. It handles execution and state, and you choose the models, tools, and machines. boxd is a first-class machine pool provider next to Blaxel, Daytona, Modal, and Unikraft, so an Omnara org can connect its own boxd organization and run every agent on a boxd machine.

​
How it works

Each Omnara machine is one boxd machine in your org. Between turns the Omnara daemon goes idle, and boxd puts the machine on standby once its network goes quiet. Memory, processes, and open sockets are kept on standby. When the agent needs the machine again, Omnara wakes it through the boxd API and the daemon is back online in 0.6 to 1.2 seconds. Machines come in boxd’s four sizes: 1 vCPU / 4 GiB, 2 vCPU / 8 GiB, 4 vCPU / 16 GiB, and 8 vCPU / 32 GiB. Save your tools in a snapshot and every new machine is created from it.

​
Set up a boxd pool

Create an API key fenced to the org your machines should run in, and store it as an Omnara org secret:
Then create the pool with that secret. sleep_after_ms idles the daemon after a minute of inactivity, which lets boxd put the machine on standby:
The Omnara dashboard works too. On the Machines page, click New pool, choose boxd, pick the secret, and pick a size. To create machines from your own snapshot, save one with boxd snapshots save <machine> <name> and pass "snapshot": "<name>" in the provider options. A machine created from a snapshot keeps the size of its source machine, so a configured size has to match it. Omnara’s machine pool docs and self-hosting configuration cover the rest, including startup_script, auto_suspend_secs, and runtime protection.