Skip to main content
Snapshots capture the filesystem and memory state of a running sandbox. Use them to save work mid-session and restore it later in a new sandbox.

Creating a Snapshot

tl sbx snapshot <sandbox-id>
tl sbx snapshot <sandbox-id> --timeout 600

Restoring from a Snapshot

Create a new sandbox from a snapshot. The new sandbox restores the captured filesystem and memory state, and inherits the image, resources, entrypoint, and secrets from the snapshot unless explicitly overridden.
tl sbx new --snapshot <snapshot-id>
tl sbx new --snapshot <snapshot-id> --cpus 4.0 --memory 2048

Clone a Sandbox

tl sbx clone creates a snapshot and immediately boots a new sandbox from it:
tl sbx clone <sandbox-id>
tl sbx clone <sandbox-id> --timeout 600

Managing Snapshots

List Snapshots

tl sbx snapshot ls

Get Snapshot Details

info = client.get_snapshot("snapshot_id")

Delete a Snapshot

tl sbx snapshot rm <snapshot-id>

snapshot_and_wait Parameters

ParameterTypeDefaultDescription
sandbox_idstrID of the running sandbox to snapshot
timeoutfloat300Max seconds to wait for completion
poll_intervalfloat1.0Seconds between status polls