Corigin
Sandboxes

Create a sandbox

A Corigin sandbox is an isolated Linux environment bound to one Corigin repository, one base ref, and one target ref. Creation returns after the base ref is available in the sandbox and the sandbox is ready.

Our sandboxes are different than most providers

  • You still get a full Linux virtual machine
  • The code is mounted automatically from the repository, so you don't have to clone it
  • The sandbox is bound to a specific base ref and target ref, so you can work on a branch without affecting the main branch
  • Persistence across restarts is bound only to the branch changes. Anything outside that is ephemeral and will be lost on restart.
corigin sandboxes create REPO_ID

The command prints the sandbox ID, repository ID, state, base ref, target ref, image version, and expiration time.

By default, the sandbox starts from the repository's configured head ref and writes to refs/heads/corigin/sandboxes/SANDBOX_ID. Use full branch refs to select either ref explicitly.

corigin sandboxes create REPO_ID \
  --base-ref refs/heads/main \
  --target-ref refs/heads/tasks/update-auth