> ## Documentation Index
> Fetch the complete documentation index at: https://docs.capy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Snapshots

> Enable or disable optional cached VM state

**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.

<Note>
  Environment Snapshots are currently available to select Enterprise customers.
  [Contact us](https://cal.com/team/capy/enterprise) to request access for your
  organization.
</Note>

The public interface intentionally exposes one setting only:

```json theme={null}
{ "enabled": true }
```

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.