Skip to main content
A snapshot is a saved copy of the disk of your sandbox. boat makes snapshots for you. You do not have to do anything.
  • boat saves the disk every minute while the sandbox runs.
  • boat saves it one more time when the sandbox stops.
  • Each save keeps only what changed, so saves are small and fast.
Memory and running programs are not in a snapshot. A resume within 10 minutes of a stop usually gets the same machine back, with memory and programs. After that, a resume is like a reboot. Read Resume within 10 minutes.

What you can do with a snapshot

Resume and fork always use the newest snapshot. You cannot go back to an older one. To keep a state that you can go back to, save a saved snapshot. Read Restore an older snapshot. For the words boat uses, and the words other providers use, read Concepts.

What comes back

  • Your files, your installed packages and your system settings come back.
  • Your Docker volumes and containers come back. Containers that ran start again.
  • Services that you enabled with systemd start again by themselves.
  • Programs that you started by hand do not come back. Start them again.
  • Memory, open connections and /tmp do not come back.
  • The IP address changes.
The list above is for a resume on a new machine. A resume within 10 minutes of the stop usually gets the same machine, and everything comes back. For the full list, read What a snapshot saves.

A stop saves first

A stop saves the disk before boat removes the machine. If the save fails, boat keeps the sandbox running and tries again for up to 3 days. After 3 days, boat does a forced stop. Read When a stop is refused. Some apps keep recent changes in memory. Chrome is an example. To save these changes before a stop, use a pre-stop command. Read Stop a sandbox.

Cost

  • Automatic snapshots are free, with no count limit. boat keeps the newest one for at least 14 days after the stop. Automated retention cleanup can delete it later once enabled. Read Keep a stopped sandbox longer than 14 days.
  • Saved snapshots have no scheduled expiry. Your plan includes some. You cannot save one during the free trial. Each one above that costs $0.056 a day from the wallet. Unpaid extras can be deleted after 7 days. Read Saved snapshot pricing.
How long boat keeps each snapshot is in Data retention.

Learn more

Stop a sandbox

What a stop does, how to save app state first, and what happens when a stop is refused.

Resume, fork and restore

Get your sandbox back, make a copy, or get older files back.

Readiness and resume speed

What works at ready, and how to wait for the rest in a script.

What a snapshot saves

Which folders come back, Docker, caches, and how to leave files out.

Saved snapshots

Save a sandbox under a name. Deploy many sandboxes from it. Share it with another account.

Download a snapshot

Look inside a snapshot and download its files.