Snapshots
Last updated January 30, 2026
Snapshots capture the state of a running sandbox, including the filesystem and installed packages. Use snapshots to skip setup time on subsequent runs.
- Faster startups: Skip dependency installation by snapshotting after setup.
- Checkpointing: Save progress on long-running tasks.
- Sharing environments: Give teammates an identical starting point.
Call snapshot() on a running sandbox:
Once you create a snapshot, the sandbox shuts down automatically and becomes unreachable. You don't need to stop it afterwards.
Pass the snapshot ID when creating a new sandbox:
View all snapshots for your project:
Look up a snapshot by ID:
Remove snapshots you no longer need:
- Snapshots expire after 30 days by default
- You can define a custom expiration time or none at all when creating a snapshot. See the SDK and CLI documentation for more details.
- See Pricing and Limits for storage costs and limits
Was this helpful?