Reference
pier deploys
Deploy history (apps + sites), incl. build logs
pier deploys <command>Deploy history (apps + sites), incl. build logs.
Subcommands
pier deploys ls
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
pier deploys info [<id>]Show deploy details.
| Argument | Required | Description |
|---|---|---|
<id> | no | Deploy ID (build_…); picked from recent deploys when omitted |
pier deploys logs
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 apply to every command.