CLI reference / sandbox / snapshot

stado sandbox snapshot

Invocation

stado sandbox snapshot <COMMAND>

Purpose

Save, list, show and delete named snapshots: a sandbox's disk kept under a name, from which `create --from` starts new sandboxes

Required inputs and options

This command has no command-specific inputs or options.

Output and state effect

This command group selects one of the subcommands listed below; use its exact child invocation to perform an operation.

Refusals

• Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.

Subcommands

• save — Freeze a sandbox's disk under a name; Boat saves it in the background
• list — List the named snapshots, newest first, with the account's allowance
• show — Show one named snapshot and its status
• delete — Delete a named snapshot for good
• history — List every snapshot of one sandbox's disk
• latest — Show the snapshot a sandbox's resume and fork start from
• tree — List the files and folders a snapshot holds, with their sizes
• get — Write a file or folder (as a tar) of a snapshot into a new local file; the sandbox need not run
• shares — List a named snapshot's share codes, active and revoked, without the codes themselves
• share — Make a secret code with which any Boat account starts a sandbox from a named snapshot (`create --from <code>`); it is printed only now, and everything on the disk is shared
• unshare — Revoke a share code; sandboxes already made from it keep their copy