Docker Images for AWS Emulator
I dug into AWS's new open source Emulator, only to find there were no container images, so I built and published my own ones.
AWS pre:Invent 2026 is in full swing. Last week Amazon gave us their new open source AWS Emulator. This gives you (almost) all AWS services on your laptop.
Since LocalStack turned their back on the community, we've been crying out for a good local experience. AWS Emulator answered our prayers.
Rather than repeat existing content, go read the AWS announcement and the blog post on how they built the emulator. I'd also suggest checking out Ran's post on his experience playing.
When I saw the emulator was Linux only I went looking for the Docker image so I could run it on my Mac. I then discovered Amazon wasn't shipping container images. Installing the Linux packages was also more convoluted than it needed to be, because there are no package repos.
All of this led to extra friction for new users.
The official container docs suggest building images without verifying the binaries. Apparently security is optional. Someone needs to share the "security is day zero" memo with the dark factory bots.
I built my own multi arch images with Debian trixie-slim as a base. The Debian base images are over 10% smaller than using Amazon Linux 2023 minimal as the base. Debian slim has become my go to base image these days.
The binaries are validated using the release signing key and precomputed hashes.
If you don't want to build your own images, grab mine from GHCR using docker run ghcr.io/skwashd/aws-emulator:latest. Pin to the image digest if you want a stable version.
I hope the AWS team will soon provide distro packages and official images. Go give the issue a thumbs up so I can retire this project. In the meantime I'll continue to provide this community service.