# pier dev

> Run the current environment locally (docker)

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

```bash
pier dev <command>
```

Run the current environment locally (docker).

## Subcommands

### pier dev up

```bash
pier dev up [flags]
```

Run the current environment locally (default).

| Flag                | Value     | Default | Description                                                                   |
| ------------------- | --------- | ------- | ----------------------------------------------------------------------------- |
| `--dry-run`         |           |         | Print the materialization plan and generated compose file; run nothing        |
| `--watch`           |           |         | Watch build contexts and rebuild/restart apps on change                       |
| `--only`            | `APP,...` |         | Run only these apps                                                           |
| `--pull-secrets`    |           |         | Reveal secret values from the server (required for protected environments)    |
| `--no-pull-secrets` |           |         | Never reveal secrets; missing ones error unless --allow-missing               |
| `--allow-missing`   |           |         | Run even when required secrets have no value (vars are absent)                |
| `--build`           |           |         | Rebuild app images even when the build context is unchanged                   |
| `--no-build`        |           |         | Never build; fail if an app image is missing                                  |
| `--keep-others`     |           |         | Leave other environments' running dev stacks alone (default: their apps stop) |

### pier dev status

```bash
pier dev status
```

Show this project's local dev stacks across environments.

### pier dev stop

```bash
pier dev stop
```

Stop the current environment's local stack (data kept).

### pier dev reset

```bash
pier dev reset [flags]
```

Destroy local dev stack(s): containers, volumes, generated files.

| Flag          | Value | Default | Description                                          |
| ------------- | ----- | ------- | ---------------------------------------------------- |
| `--all`       |       |         | Reset every environment's dev stack for this project |
| `-y`, `--yes` |       |         | Skip confirmation prompt                             |

### pier dev logs

```bash
pier dev logs [<app>]
```

Follow the local stack's logs.

| Argument | Required | Description      |
| -------- | -------- | ---------------- |
| `<app>`  | no       | Limit to one app |

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