Suspend & resume - vpod

A running sandbox can be suspended: its state is serialized to disk and reconstructed on demand when you resume it. Nothing keeps running in between — there is no daemon or background process to manage.

from vpod import Sandbox

with Sandbox.create() as sandbox:
    sandbox.commands.run("export SECRET=42")
    instance_id = sandbox.suspend()

# Later (even from a new process):
with Sandbox.resume(instance_id) as sandbox:
    result = sandbox.commands.run("echo $SECRET")
    print(result.stdout)  # 42

# Delete the suspended instance from disk when you no longer need it
Sandbox.destroy(instance_id)

Suspending only writes what changed since boot, which keeps the operation fast and the saved state small. Anything the guest held carries across, including variables set with env at creation. Pass env to Sandbox.resume only when you want to add or change one on the way back up.

Managing instances

Method	Description
`sandbox.suspend()`	Suspend to disk, returns an instance ID
`Sandbox.resume(id)`	Resume a suspended instance
`Sandbox.list_instances()`	List all instances
`Sandbox.destroy(id)`	Delete a suspended instance from disk

sandbox.close() shuts down a running sandbox but leaves suspended instances untouched — use Sandbox.destroy(id) to remove them from disk.