Skip to main content
Snapshots optionally cache a project’s VM state to speed later starts. They are independent from Setup: Setup can always be saved and tested with a fresh run whether Snapshots are enabled or disabled.
Environment Snapshots are currently available to select Enterprise customers. Contact us to request access for your organization.
The public interface intentionally exposes one setting only:
Saving Setup is required before enabling Snapshots. Enabling can:
  • Reuse a matching current artifact (reusedSnapshot)
  • Start the first build immediately (initialBuildId)
  • Queue the first build behind one already running (queuedBehindActiveBuild)
If the first build cannot be admitted or dispatched, Snapshots remain disabled. Snapshot builds clone each repository at its configured base branch, run Initialize, scrub platform-managed credentials and environment files, and then capture the VM. Restored runs receive current environment variables and credentials before Update after checkout and Startup are evaluated.