# atmos emulator ps

Use this command to list the running emulator containers in the component's stack. Containers are discovered by the labels derived from their canonical instance addresses.

## Usage

```shell
atmos emulator ps <component> --stack <stack> [flags]
```

## Examples

```shell
# List running emulators in the plat-ue2-dev stack
atmos emulator ps aws --stack=plat-ue2-dev

# Using the emu alias
atmos emu ps aws --stack=plat-ue2-dev
```

## Arguments

- **`component`**
  **Required.**
   The emulator component whose stack is inspected (for example, 
  `aws`
  ).

## Flags

- **`-s, --stack`**
  **Required.**
   The stack to list running emulators for (for example, 
  `plat-ue2-dev`
  ).

## Try it out

Requires Docker or Podman and network access for the image. Start the local AWS emulator, then stop and remove it when finished.

```shell
atmos emulator up aws -s local
atmos emulator ps aws -s local
atmos emulator down aws -s local
```

## See Also

- [`atmos emulator up`](/cli/commands/emulator/up) — Start (or reuse) the emulator container
- [`atmos emulator logs`](/cli/commands/emulator/logs) — Stream the emulator container's logs