Skip to main content
Hibernate captures paused sandbox state for a running sandbox and stops the active VM. Use reusable snapshots when the source should keep running and the captured state should start many future sandboxes.

​
What state changes

  • The running sandbox stops accepting new work.
  • A paused-sandbox snapshot ID is created and returned for Sandbox.resume(...).
  • Shared volume attachments are preserved as remount intent, not as VM memory.

​
Usage

from nullspace import Sandbox

sandbox = Sandbox.create(template="base", timeout=600)
sandbox.files.write("/workspace/state.txt", "before hibernate\n")
snapshot = sandbox.hibernate()
print(snapshot.id)
API reference: hibernateSandbox (POST /v1/sandboxes/{id}/hibernate). Reusable snapshot API: Snapshots. Guide: Sandbox lifecycle. Example: Examples.