# AWS Local Emulator Choice Matrix

**Dated:** 12 November 2026  
**Companion post:** [AWS Emulator (11 Nov 2026): When to Use It Instead of MiniStack or floci](/blog/aws-emulator-local-testing-2026/)  
**Sister post:** [Two Free LocalStack Alternatives in 2026: MiniStack vs floci](/blog/ministack-free-localstack-alternative-aws-emulator/)

---

## How to use this matrix

Find the row that matches your primary constraint. The **Choice** column gives the recommended tool. The **Source** column links the fact that drives the recommendation so you can re-verify it as tools evolve.

> **Idle RAM for AWS Emulator was not measured in this artifact.** One Apple M4 Docker run on 12 Nov 2026 reached health in 2 seconds after `docker run`. That is one sample, including container start, not a startup benchmark. See the section below and [smoke-2026-11-12.txt](/examples/architecture-blog-2026/aws-emulator-local-choice/smoke-2026-11-12.txt). MiniStack and floci figures are from the sister post (July 2026). Re-verify them before a capacity plan.

---

## Decision matrix

| # | Constraint | Choice | Notes | Source |
|---|---|---|---|---|
| 1 | Need control-plane error codes and messages that match real us-west-2; no AWS account in CI | **AWS Emulator — pin a release, start with `--telemetry off`** | Fidelity calibrated against us-west-2 (global services: us-east-1). Pin an explicit release tag (e.g., v1.0.322). Floating `latest` means error text can change between runs. | [Fidelity in AWS Emulator](https://docs.aws.amazon.com/emulator/latest/userguide/fidelity.html); [v1.0.322 release](https://github.com/aws/aws-emulator/releases/tag/v1.0.322) |
| 2 | Tests need real Postgres, MySQL, or Redis semantics (connection pooling, transaction isolation, caching) | **MiniStack** | MiniStack spins up actual Postgres and Redis containers. AWS Emulator keeps all state in memory with no database engine. | [MiniStack sister post, July 2026](/blog/ministack-free-localstack-alternative-aws-emulator/); project-advertised, re-verify |
| 3 | CI depends on millisecond startup and `http://localhost:4566` (existing suite, no migration budget) | **floci** | floci starts in ~24 ms (project-advertised, July 2026, re-verify) and listens on `http://localhost:4566`. Moving to AWS Emulator means HTTPS, a CA bundle, and generated keys. That is an SDK rewire, not a port change. | [floci sister post, July 2026](/blog/ministack-free-localstack-alternative-aws-emulator/); project-advertised, re-verify |
| 4 | Already paying for LocalStack Pro and the pipeline is stable | **Stay on LocalStack Pro** | Switching has real migration cost. If the pipeline is green and the team is productive, the cost of migration is higher than the cost of the subscription unless a specific limitation is blocking work. | Opportunity cost; no primary source |
| 5 | IAM policy evaluation, resource-based policy conditions, or service control policy tests | **Real AWS — not AWS Emulator** | The AWS Emulator user guide states explicitly: do not use it to test security. IAM and resource policies are not evaluated the way AWS does. This matrix does not re-test MiniStack or floci IAM. Use a sandboxed real AWS account for policy tests. | [What is AWS Emulator? — Limitations](https://docs.aws.amazon.com/emulator/latest/userguide/what-is-service.html) |
| 6 | Multi-Region isolation in one process | **Not AWS Emulator — run one process per Region** | AWS Emulator accepts any Region and account ID but does not keep resources separate by Region or account in one process. To test two Regions, run two emulator processes on different ports (for example 9297 and 9298). MiniStack and floci were not compared on this point. | [What is AWS Emulator? — Limitations](https://docs.aws.amazon.com/emulator/latest/userguide/what-is-service.html) |
| 7 | Port and scheme comparison | **AWS Emulator: `https://127.0.0.1:9297` — others: `http://localhost:4566`** | AWS Emulator requires HTTPS and a generated CA bundle. Use `127.0.0.1`, not `localhost`: JS, Java, and Go SDKs inject the S3 bucket name into the hostname when using `localhost`, which the emulator rejects. S3 Control always injects the account ID into the hostname and never reaches the emulator. | [Pointing your AWS SDK at AWS Emulator](https://docs.aws.amazon.com/emulator/latest/userguide/point-sdk-to-emulator.html) |
| 8 | Data-plane tests (S3 object gets/puts, DynamoDB query semantics, Kinesis shard reads) | **Treat as unverified on AWS Emulator — check fidelity scores for your services** | The fidelity docs state that the emulator matches AWS most closely for control-plane APIs. Data-plane fidelity varies by service. Check the per-service scores on the release you pin before relying on data-plane behavior. | [Fidelity in AWS Emulator](https://docs.aws.amazon.com/emulator/latest/userguide/fidelity.html) |

---

## Verifying you are on the emulator (not real AWS)

Run this after setting the environment variables:

```bash
aws sts get-caller-identity
```

**Expected when the call reached AWS Emulator:** `Account` is `000000000000` and `Arn` is `arn:aws:iam::000000000000:user/emulator`. The user guide does not publish a sample `UserId`, so this artifact does not invent one.

If `Account` shows your real AWS account ID, `AWS_ENDPOINT_URL` is not set in the current shell, or real credentials (`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_SESSION_TOKEN`, `AWS_PROFILE`) are set and overriding the emulator's generated keys. Unset them and run again.

## One run on 12 Nov 2026

Apple M4, Docker, package `aws-emulator-1.0.322-1.aarch64` from the LTS latest aarch64 RPM URL that day. Telemetry off, 2 GiB cap, port published only on `127.0.0.1`.

- Health body `ok`, 2 seconds after `docker run` (includes container start; not a startup benchmark; RAM not measured).
- `sts get-caller-identity`: account `000000000000`, Arn `arn:aws:iam::000000000000:user/emulator`.
- `CreateTable` name `ab`: `ValidationException`, length must be at least 3. Matches the user guide.
- `CreateBucket` name `amzn-s3-demo-bucket`: `InvalidBucketName`, "The specified bucket is not valid." The user guide shows that name succeeding. This run did not send the same call to real S3.
- `CreateBucket` name `fm-smoke-9297`: `Location` `/fm-smoke-9297`.

Transcript: [smoke-2026-11-12.txt](/examples/architecture-blog-2026/aws-emulator-local-choice/smoke-2026-11-12.txt).

---

## Environment variable reference (macOS/Linux, port 9297)

```bash
export AWS_ENDPOINT_URL=https://127.0.0.1:9297
export AWS_SHARED_CREDENTIALS_FILE=~/.aws/emulator/9297/emulator_credentials
export AWS_CONFIG_FILE=~/.aws/emulator/9297/config
export AWS_CA_BUNDLE=~/.aws/emulator/9297/ca.pem
export AWS_EC2_METADATA_DISABLED=true
export AWS_DISABLE_HOST_PREFIX_INJECTION=true
export AWS_REGION=us-east-1
export AWS_DEFAULT_REGION=us-east-1
unset AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_SESSION_TOKEN AWS_PROFILE
```

Start the emulator with `--telemetry off` as a separate flag when invoking `aws-emulator`. Requires AWS CLI 2.35.0 or later.

Source: [Pointing your AWS SDK at AWS Emulator](https://docs.aws.amazon.com/emulator/latest/userguide/point-sdk-to-emulator.html)

---

## Tool summary at a glance

| | AWS Emulator v1.0.322 | MiniStack (mid-2026) | floci (mid-2026) | LocalStack Pro |
|---|---|---|---|---|
| Port/scheme | `https://127.0.0.1:9297` | `http://localhost:4566` | `http://localhost:4566` | `http://localhost:4566` |
| License | CC0 (vendor: Apache-2.0) | MIT | MIT | Proprietary (sister post) |
| State | In-memory; wiped on stop | Real DB containers while the process runs | In-process APIs; DB containers on demand | Not compared here |
| Real DB containers | No | Yes (Postgres/MySQL/Redis) | On demand for DB and cache | Paid tier includes RDS (sister post) |
| IAM evaluation | Not like AWS | Not compared here | Not compared here | Not compared here |
| Startup time | 2 s to health after docker run, one M4 sample on 12 Nov 2026 (not a benchmark) | ~2 s (sister post, July 2026) | ~24 ms (sister post, July 2026) | 15–30 s (sister post, July 2026) |
| RAM at idle | Not measured (12 Nov 2026) | ~30 MB (sister post, July 2026) | ~13 MiB (sister post, July 2026) | ~500 MB (sister post, July 2026) |
| Telemetry | On by default | None (sister post) | None (sister post) | Not compared here |
| Price | No emulator fee | Free (sister post) | Free (sister post) | $35+/month (sister post, July 2026) |
| Accepts pull requests | No (README, v1.0.322) | Not checked on 12 Nov 2026 | Not checked on 12 Nov 2026 | Not checked on 12 Nov 2026 |

Project-advertised figures are from the [MiniStack vs floci sister post](/blog/ministack-free-localstack-alternative-aws-emulator/). Re-verify against current releases before committing to a platform choice.

---

## Sources

- [AWS What's New: AWS Emulator now available, 11 Nov 2026](https://aws.amazon.com/about-aws/whats-new/2026/11/aws-emulator-now-available/)
- [What is AWS Emulator? (Limitations)](https://docs.aws.amazon.com/emulator/latest/userguide/what-is-service.html)
- [Fidelity in AWS Emulator](https://docs.aws.amazon.com/emulator/latest/userguide/fidelity.html)
- [Getting started with Docker — AWS Emulator](https://docs.aws.amazon.com/emulator/latest/userguide/getting-started-docker.html)
- [Pointing your AWS SDK at AWS Emulator](https://docs.aws.amazon.com/emulator/latest/userguide/point-sdk-to-emulator.html)
- [aws/aws-emulator release v1.0.322](https://github.com/aws/aws-emulator/releases/tag/v1.0.322)
- [Matthew Goldberg, About Amazon, 11 Nov 2026](https://www.aboutamazon.com/news/aws/how-autonomous-ai-agents-built-aws-emulator)
- MiniStack and floci figures: project-advertised, July 2026; see [sister post](/blog/ministack-free-localstack-alternative-aws-emulator/)
