Skip to content
Projects

D33ptar00p/emulator-ui has 19 GitHub stars and 5 forks. GitHot measured +1 stars in 24 hours. Last checked 2026-11-15 16:57 UTC. Last push 2026-11-12.

How these counts are measured

19 stars5 Forks +1 in 24h

What you can do

  • Dashboard: search all 436 services. Services holding resources are listed first, the rest are grouped by category. The sidebar lists only active services, with counts.
  • Any service: browse its resources as tables, or run any API operation from a JSON editor pre-filled from the API model.
  • DynamoDB items, S3 browser, Lambda invoke;
  • API Gateway requests;

Measured star growth

in 24h
+1
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

A web console for AWS Emulator: browse and drive every emulated service locally

Web & Apps

README.md

Original

Emulator UI logo

Emulator UI

Emulator UI

A web console for AWS Emulator.

Browse and interact with the resources in a locally running AWS Emulator, for all 436 services it supports.

CI services: 436 tested with: emulator v1.0.322 Python: 3.11+ React: 18.3 FastAPI: 0.115+ license: Apache 2.0

Quick start ◆ Emulator requirements ◆ Features ◆ Development ◆ Contact

Emulator UI demo: dashboard, search, DynamoDB items, S3, Step Functions history and running an API operation

Quick start

Requires Docker and a running AWS Emulator (see Emulator requirements).

git clone https://github.com/D33ptar00p/emulator-ui.git && cd emulator-ui
make up-image   # pull the prebuilt image (amd64/arm64) + start -> http://127.0.0.1:8080
make up         # or build the image from source
make down       # stop the console

The console runs in its own container and never starts or stops emulators. Start them in any order; the console picks up emulator restarts, new regions and new keys on its own.

Emulator requirements

Container named aws-emulator-<port> (default port 9297), on the Docker network aws-emulator, listening on 0.0.0.0:<port> inside the container
Files the emulator's emulator_credentials, config and ca.pem in ~/.aws/emulator/<port>/ on the host
Host port published on 127.0.0.1:<port> (used by make dev and make test)
Regions (optional) ~/.aws/emulator/regions with region=port lines for regions that have their own emulator

Example, with an image built from the official Dockerfile and tagged aws-emulator:

docker network create aws-emulator 2>/dev/null || true
mkdir -p ~/.aws/emulator
docker run -d --rm --name aws-emulator-9297 --network aws-emulator \
  --user "$(id -u):$(id -g)" -p 127.0.0.1:9297:9297 \
  -e HOME="$HOME" -v "$HOME/.aws/emulator:$HOME/.aws/emulator" \
  aws-emulator -p 9297 --telemetry off

Features

  • Dashboard: search all 436 services. Services holding resources are listed first, the rest are grouped by category. The sidebar lists only active services, with counts.

  • Any service: browse its resources as tables, or run any API operation from a JSON editor pre-filled from the API model.

  • Dedicated pages:

    • DynamoDB items, S3 browser, Lambda invoke;
    • API Gateway requests;
    • Step Functions executions, EventBridge events, SQS messages;
    • AppSync and IAM.
  • Region switcher: shared regions use the default emulator; isolated regions (listed in ~/.aws/emulator/regions) get their own.

  • Safe by default:

    • localhost only;
    • CSRF and DNS-rebinding guards;
    • never calls a non-local endpoint;
    • destructive actions ask for confirmation.

    See SECURITY.md.

Resource counts exclude the items a fresh emulator already has (recorded in src/emulator_ui/inventory_baseline.json).

Troubleshooting

Symptom Fix
"Emulator unreachable" / "Emulator is off." Start an emulator that meets the requirements.
No resources Emulators keep state in memory, so a new run is empty. Create resources, then click Rescan resources.
Resource missing in another region Check the region switcher; regions can be isolated.
"Not implemented by the emulator yet (501)" The emulator doesn't support that operation yet.

Development

make dev           # API on :8081 with reload + Vite on http://127.0.0.1:5173
make test          # backend tests (live tests need a running emulator)
make ui-test       # frontend typecheck + tests
make lint          # ruff + shellcheck
make catalog       # regenerate the service catalog and icons (offline)
make inventory-baseline   # re-record a fresh emulator's built-in items

Backend: FastAPI in src/emulator_ui/. Frontend: React + TypeScript (Vite) in ui/. Inside the container, the console reaches each emulator over the aws-emulator network through a loopback relay, so TLS is verified end to end against the emulator's own certificate. API docs: http://127.0.0.1:8080/api/docs.

Contact

License

Apache License 2.0. Copyright 2026 Deeptaroop Mojumdar. See NOTICE.