# pier deploys

> Deploy history (apps + sites), incl. build logs

URL: https://pier.run/docs/cli/reference/deploys

```bash
pier deploys <command>
```

Deploy history (apps + sites), incl. build logs.

## Subcommands

### pier deploys ls

```bash
pier deploys ls [<ref>] [flags]
```

List deploys (apps + sites).

| Argument | Required | Description                                      |
| -------- | -------- | ------------------------------------------------ |
| `<ref>`  | no       | Narrow to one app or site (slug, or slug/target) |

| Flag         | Value    | Default | Description                                                            |
| ------------ | -------- | ------- | ---------------------------------------------------------------------- |
| `--type`     | `STRING` |         | Filter by resource type: app or site                                   |
| `--limit`    | `INT`    |         | Max rows (server default 50, max 200)                                  |
| `--system`   |          |         | Include platform-initiated rollouts (drift repair, resume, relocation) |
| `--all-envs` |          |         | Every environment (default: the current one only)                      |

### pier deploys info

```bash
pier deploys info [<id>]
```

Show deploy details.

| Argument | Required | Description                                                   |
| -------- | -------- | ------------------------------------------------------------- |
| `<id>`   | no       | Deploy ID (build\_…); picked from recent deploys when omitted |

### pier deploys logs

```bash
pier deploys logs [<id>] [flags]
```

Show build logs for a deploy.

| Argument | Required | Description                                                   |
| -------- | -------- | ------------------------------------------------------------- |
| `<id>`   | no       | Deploy ID (build\_…); picked from recent deploys when omitted |

| Flag             | Value    | Default | Description                                          |
| ---------------- | -------- | ------- | ---------------------------------------------------- |
| `--tail`         | `2000`   | `2000`  | Max log lines                                        |
| `--query`        | `STRING` |         | Full-text search filter                              |
| `-f`, `--follow` |          |         | Follow the live log stream until the build completes |

[Global flags](/docs/cli/reference#global-flags) apply to every command.