# 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

### emulator-aws

Copy the example into a new directory and make it your own:

```shell
atmos init examples/emulator-aws
cd emulator-aws
```

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
```

- [Installation guide](/install)
- [Explore the example](/examples/emulator-aws)
- [Initialization and repository settings](/cli/commands/init#examples-and-source-directories)

## 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