Filesystem snapshots supported on Vercel Sandboxes

Vercel Sandbox now supports filesystem snapshots to capture your state. You can capture a Sandbox's complete filesystem state as a snapshot and launch new Sandboxes from that snapshot using the Sandbox API.

This eliminates repeated setup when working with expensive operations like dependency installation, builds, or fixture creation. Create the environment once, snapshot it, then reuse that exact filesystem state across multiple isolated runs.

Link to headingHow snapshots work

Snapshots capture the entire filesystem of a running Sandbox. New Sandboxes can launch from that snapshot, providing immediate access to pre-installed dependencies and configured environments.

Link to headingKey capabilities

• Create a snapshot from any running Sandbox with sandbox.snapshot()

• Launch new Sandboxes from snapshots via source: { type: 'snapshot', snapshotId }

• Reuse the same snapshot with multiple Sandboxes for parallel testing and experimentation

1
import { Sandbox } from '@vercel/sandbox';
2

3
const sandbox = await Sandbox.create();
4
await sandbox.writeFiles([{
5
  path: '/vercel/sandbox/hello',
6
  content: Buffer.from('Hello Vercel Sandbox and Snapshots'),
7
}]);
8
const snapshot = await sandbox.snapshot();
9

10
const newSandbox = await Sandbox.create({
11
  source: { type: 'snapshot', snapshotId: snapshot.snapshotId },
12
});
13
for await (const chunk of await newSandbox.readFile({ path: '/vercel/sandbox/hello' })) {
14
  process.stdout.write(chunk);
15
};

See the documentation to get started with snapshots.