# pier environments

> Environments: list, add, pause (switch with 'pier use')

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

```bash
pier environments <command>
```

Environments: list, add, pause (switch with 'pier use').

## Subcommands

### pier environments ls

```bash
pier environments ls
```

List environments.

### pier environments add

```bash
pier environments add <name> [flags]
```

Add an environment.

| Argument | Required | Description                     |
| -------- | -------- | ------------------------------- |
| `<name>` | yes      | Environment name (e.g. Staging) |

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

### pier environments pause

```bash
pier environments pause [flags]
```

Pause an environment (recoverable).

| Flag          | Value | Default | Description                                                         |
| ------------- | ----- | ------- | ------------------------------------------------------------------- |
| `-y`, `--yes` |       |         | Skip confirmation                                                   |
| `--no-wait`   |       |         | Return immediately after submitting; don't wait for terminal status |

### pier environments resume

```bash
pier environments resume [flags]
```

Resume a paused environment.

| Flag        | Value | Default | Description                                                         |
| ----------- | ----- | ------- | ------------------------------------------------------------------- |
| `--no-wait` |       |         | Return immediately after submitting; don't wait for terminal status |

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