Snap

A snap is a storage branch point for boxes. It lets you save one file system state and reuse or fork it later.

Commands

⌘Copyrun9 snap import <image-ref>
run9 snap fork <snap-id>
run9 snap fork --from-box <box-id>
run9 snap ls
run9 snap inspect <snap-id>
run9 snap rm <snap-id>

Output

Default output is readable text:

• snap import and snap fork print OK: plus the created snap id.
• snap ls prints a compact table.
• snap inspect prints a summary.
• snap rm prints a short confirmation.

Use JSON for automation:

⌘Copyrun9 --json snap inspect <snap-id>
run9 --output json snap ls

Import an image

Bring in a new base from an external image:

⌘Copyrun9 snap import public.ecr.aws/docker/library/alpine:3.20

Fork from a snap

Start another branch from an existing saved baseline:

⌘Copyrun9 snap fork <snap-id>

Fork from a box

Stop the box first so the file system is quiet:

⌘Copyrun9 box stop my-box
run9 snap fork --from-box my-box

Use --from-box when the state you want to save still lives in a box rather than in a previous snap.

List and inspect

⌘Copyrun9 snap ls
run9 snap ls --attached false
run9 snap inspect <snap-id>