# atmos emulator list

Use this command to list emulator containers in a clean, theme-aware table with a status dot (green when running), a short image name, and the container ID. Containers are discovered by the labels derived from their canonical instance addresses. Scope the output to a single stack with `--stack`, or omit it to list emulators across every stack.

## Usage

```shell
atmos emulator list [flags]
```

Unlike [`atmos emulator ps`](/cli/commands/emulator/ps), `list` does not take a component argument — it lists every emulator (optionally filtered by stack).

## Examples

```shell
# List emulators across all stacks
atmos emulator list

# List emulators in a single stack
atmos emulator list --stack=plat-ue2-dev

# Using the emu alias and the ls shorthand
atmos emu ls --stack=plat-ue2-dev
```

## Flags

- **`-s, --stack`** — Optional. Restrict the listing to a single stack (for example, `plat-ue2-dev`). When omitted, emulators from every stack are listed.

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

Inspect the configured AWS emulator.

```shell
atmos emulator list
```

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

## See Also

- [`atmos emulator ps`](/cli/commands/emulator/ps) — List running emulators in a component's stack
- [`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