Commands / kosa8 snapshot pull
kosa8 snapshot pull
Download a snapshot from remote storage, ready to restore
Usage
kosa8 pull SNAPSHOT
Downloads a snapshot from R2 into the local store.
A snapshot pushed with --incremental is pulled as chunks: the root's signature is checked (--trust pins the signer), chunks this machine already has in other snapshots of the same sandbox (or in --base) are not fetched, every chunk fetched is checked against its digest, and an interrupted pull, run again, fetches only what it did not get. The snapshot appears locally only once it is whole.
Under an org policy with require_snapshot_encryption, a snapshot that was pushed in plaintext is refused before any of it is downloaded.
Options
| Flag | Type | What it does | Default |
|---|---|---|---|
--base | stringArray | a local snapshot to take chunks from before fetching them (repeatable) | [] |
--parallel | int | requests in flight at once; on a high-latency link more hide the round trip | 4 |
--retries | int | attempts per request before giving up (with backoff); a failed transfer resumes when run again | 10 |
--trust | string | require the snapshot to be signed by this Ed25519 public key (file or base64) | — |