# snapdir fetch

Fetch a snapshot from a store into the local cache.

`fetch` downloads the manifest and objects for a snapshot from a `--store` into
the local cache, without checking them out to a working directory. Use
[`snapdir checkout`](snapdir-checkout.md) afterward to materialize the files, or
[`snapdir pull`](snapdir-pull.md) to do both at once.

## Usage

```text
snapdir fetch [OPTIONS]
```

### Options

`fetch` takes no positional arguments. It accepts the
[global options](overview.md#global-options); the most relevant are `--store`
(source), `--id` (snapshot to fetch), and the transfer-tuning flags `-j`/`--jobs`,
`--limit-rate`, and `--adaptive`.

## Examples

Fetch a snapshot by ID from an S3 store:

```console
snapdir fetch --id 1220abc... --store s3://my-bucket/snapshots
```

Fetch from a local file store, adaptively tuning concurrency:

```console
snapdir fetch --id 1220abc... --store file:///srv/backups --adaptive
```

## See also

- [`snapdir checkout`](snapdir-checkout.md) — materialize a fetched snapshot
- [`snapdir pull`](snapdir-pull.md) — fetch and check out in one step
- [`snapdir push`](snapdir-push.md) — the inverse direction
- [Pushing and pulling guide](../guide/pushing-pulling.md)