Skip to main content
The exe.dev sandbox provider is under development. It requires building Fabro with the exedev feature flag enabled. The API and configuration may change.
exe.dev provides fast ephemeral cloud VMs for Fabro workflows. Each run gets a fresh VM with full machine-level isolation, connected via SSH.

​
How it works

  • Each run creates a new VM via the exe.dev management plane over SSH
  • Fabro clones the current git repository into the VM automatically (using GitHub App credentials for private repos)
  • Agent tool calls (shell commands, file edits, grep, glob) execute over SSH inside the VM
  • Git checkpointing commits agent changes to a remote branch between stages
  • Cancelling a run cleanly tears down the VM
  • VMs are destroyed automatically when the run finishes

​
Configuration

fabro run workflow.fabro --sandbox exe
run.toml
[sandbox]
provider = "exe"

[sandbox.exe]
image = "my-custom-image:latest"
FieldDescription
imageCustom container image for the VM. Optional — uses the exe.dev default when omitted.

​
SSH access

Connect to a running exe.dev sandbox via SSH for live debugging: 
fabro run workflow.fabro --sandbox exe --ssh
This prints the SSH connection command so you can connect to the VM while the workflow runs.

​
Prerequisites

  • SSH keys configured for exe.dev (added via the exe.dev dashboard)
  • A GitHub App configured via fabro install (for private repository cloning)
See Environments for additional details on how the exe.dev sandbox operates.