Skip to main content

Overview

Remote sandboxes run your session in a managed cloud container while keeping the same context and workspace. When you migrate, Omnara restores your workspace from a synced checkpoint or a Git clone, runs any workspace setup scripts, and reconnects the session.

Requirements

  • Workspace sync enabled
  • At least one checkpoint uploaded
  • GitHub connected or the Omnara GitHub App installed for GitHub repos

Migrate to Sandbox

  1. Open the dashboard session panel
  2. Choose Sandbox as the execution target or click the cloud icon
  3. Wait for the sandbox to start and reconnect

Resume and Recovery

Sandboxes send heartbeats while active. If a sandbox stops responding, Omnara can restart it and resume the session automatically.

Migrate Back to Local

Switch the execution target back to Local from the same UI.

Notes

  • Sandbox sessions run from the restored workspace state
  • Git operations in the sandbox authenticate through the Omnara GitHub App — local git credentials are not used