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

What state changes

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

Usage

from nullspace import Machine

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