# pier rm

> Remove a resource

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

```bash
pier rm <command>
```

Remove a resource.

## Subcommands

### pier rm app

```bash
pier rm app [<app>] [flags]
```

Remove an app.

| Argument | Required | Description           |
| -------- | -------- | --------------------- |
| `<app>`  | no       | App name, slug, or ID |

| Flag          | Value | Default | Description                                                         |
| ------------- | ----- | ------- | ------------------------------------------------------------------- |
| `-y`, `--yes` |       |         | Skip confirmation prompt                                            |
| `--stage`     |       |         | Write the change to pier.yaml only — apply later with 'pier deploy' |

### pier rm site

```bash
pier rm site [<site>] [flags]
```

Remove a site.

| Argument | Required | Description       |
| -------- | -------- | ----------------- |
| `<site>` | no       | Site name or slug |

| Flag          | Value | Default | Description                                                         |
| ------------- | ----- | ------- | ------------------------------------------------------------------- |
| `-y`, `--yes` |       |         | Skip confirmation prompt                                            |
| `--stage`     |       |         | Write the change to pier.yaml only — apply later with 'pier deploy' |

### pier rm pg

```bash
pier rm pg [<postgres>] [flags]
```

Remove a Postgres instance.

| Argument     | Required | Description           |
| ------------ | -------- | --------------------- |
| `<postgres>` | no       | Postgres name or slug |

| Flag          | Value | Default | Description                                                         |
| ------------- | ----- | ------- | ------------------------------------------------------------------- |
| `-y`, `--yes` |       |         | Skip confirmation prompt                                            |
| `--stage`     |       |         | Write the change to pier.yaml only — apply later with 'pier deploy' |

### pier rm bucket

```bash
pier rm bucket [<bucket>] [flags]
```

Remove a bucket.

| Argument   | Required | Description         |
| ---------- | -------- | ------------------- |
| `<bucket>` | no       | Bucket name or slug |

| Flag          | Value | Default | Description                                                         |
| ------------- | ----- | ------- | ------------------------------------------------------------------- |
| `-y`, `--yes` |       |         | Skip confirmation prompt                                            |
| `--stage`     |       |         | Write the change to pier.yaml only — apply later with 'pier deploy' |

### pier rm volume

```bash
pier rm volume [<volume>] [flags]
```

Remove a volume.

| Argument   | Required | Description              |
| ---------- | -------- | ------------------------ |
| `<volume>` | no       | Volume name, slug, or ID |

| Flag          | Value | Default | Description                                                         |
| ------------- | ----- | ------- | ------------------------------------------------------------------- |
| `-y`, `--yes` |       |         | Skip confirmation                                                   |
| `--stage`     |       |         | Write the change to pier.yaml only — apply later with 'pier deploy' |

### pier rm domain

```bash
pier rm domain [<domain>] [flags]
```

Remove a custom domain.

| Argument   | Required | Description                               |
| ---------- | -------- | ----------------------------------------- |
| `<domain>` | no       | Domain to delete (interactive if omitted) |

| Flag           | Value    | Default | Description                                                         |
| -------------- | -------- | ------- | ------------------------------------------------------------------- |
| `-a`, `--app`  | `STRING` |         | App ref narrowing the --stage selection (slug or slug/target)       |
| `-s`, `--site` | `STRING` |         | Site ref narrowing the --stage selection (slug or slug/target)      |
| `-y`, `--yes`  |          |         | Skip confirmation                                                   |
| `--stage`      |          |         | Write the change to pier.yaml only — apply later with 'pier deploy' |

### pier rm target

```bash
pier rm target <ref> [flags]
```

Remove a deployment target from an app or site.

| Argument | Required | Description                                                       |
| -------- | -------- | ----------------------------------------------------------------- |
| `<ref>`  | yes      | Target to remove (name/target of an app or site, e.g. web/feat-x) |

| Flag          | Value | Default | Description              |
| ------------- | ----- | ------- | ------------------------ |
| `-y`, `--yes` |       |         | Skip confirmation prompt |

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