# snapdir pull

Fetch a snapshot from a store and check it out to the given path.

`pull` is the one-step combination of [`snapdir fetch`](snapdir-fetch.md) and
[`snapdir checkout`](snapdir-checkout.md): it downloads the snapshot from a
`--store` into the cache and materializes it at the destination directory.

## Usage

```text
snapdir pull [OPTIONS] [PATH]
```

### Arguments

| Argument | Description |
| --- | --- |
| `[PATH]` | Destination directory. |

### Options

`pull` accepts the [global options](overview.md#global-options); the most
relevant are `--store` (source), `--id` (snapshot to pull), and `--linked` to
materialize via symlinks into the cache.

## Examples

Pull a snapshot from S3 into a new directory:

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

Pull from a local file store using symlinks:

```console
snapdir pull --id 1220abc... --store file:///srv/backups --linked ./restored
```

## See also

- [`snapdir fetch`](snapdir-fetch.md) — fetch only, no checkout
- [`snapdir checkout`](snapdir-checkout.md) — check out an already-cached snapshot
- [`snapdir push`](snapdir-push.md) — the inverse direction
- [Pushing and pulling guide](../guide/pushing-pulling.md)