# atmos emulator reset

Use this command to stop and remove the emulator's container and then delete its persisted state directory under the XDG cache. The next [`atmos emulator up`](/cli/commands/emulator/up) starts a fresh instance. This is the deliberate counterpart to [`atmos emulator down`](/cli/commands/emulator/down), which keeps persisted state.

## Usage

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

Unless `--force` is set, `reset` prompts for confirmation before deleting persisted state.

## Examples

```shell
# Stop the aws emulator and wipe its persisted state (with a confirmation prompt)
atmos emulator reset aws --stack=plat-ue2-dev

# Wipe without prompting
atmos emulator reset aws --stack=plat-ue2-dev --force

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

## Arguments

- **`component`** — **Required.** The emulator component to reset (for example, `aws`).

## Flags

- **`-s, --stack`** — **Required.** The stack the emulator component belongs to (for example, `plat-ue2-dev`).
- **`-f, --force`** — Wipe persisted state without prompting for confirmation. Also settable with `ATMOS_EMULATOR_RESET_FORCE=true`.

## See Also

- [`atmos emulator up`](/cli/commands/emulator/up) — Start (or reuse) the emulator container
- [`atmos emulator down`](/cli/commands/emulator/down) — Stop and remove the emulator container (state is kept)
- [`atmos emulator ps`](/cli/commands/emulator/ps) — List running emulators in the stack