Skip to main content

Kaer NewsSoftware

AWS launches open-source AWS Emulator for local cloud testing

AWS Emulator, a free open-source local emulator in Rust, lets developers test against nearly every AWS service on their own machine.

3 min read
AWS launches open-source AWS Emulator for local cloud testingPhoto: AWS News Blog

Key points

AWS launched AWS Emulator, a free open-source local emulator in Rust, letting developers test against nearly every AWS service on their own machine.

AWS launched AWS Emulator, a free, open-source local emulator in Rust, on 11 November, letting developers test applications against nearly every AWS service on their own machine. The emulator uses the same CLI and SDK commands, with fidelity measured against real AWS behavior. It has no additional service fee, and developers pay only for AWS resources when they deploy on AWS.

The emulator runs as a local HTTPS endpoint on 127.0.0.1:9297, so only the developer's own computer can reach it. When it starts, it generates its own credentials, a config file, and a certificate, writing them to ~/.aws/emulator/9297/. Developers set environment variables to point the AWS SDK at the laptop instead of AWS, and application code stays unchanged.

How it works

AWS Emulator is implemented in Rust to stay light on CPU and memory on a laptop. It supports the APIs of AWS services that have an API model in the AWS API models repository on GitHub. Because it is built from those models, the same ones the AWS SDKs use, requests and errors have the same shape as on AWS.

The emulator generates new keys each time it starts, with access key IDs starting with EMULATOR, so they cannot be mistaken for real AWS keys. It rejects requests signed with any other keys. The emulator uses a single account, 000000000000. For tests, AWS Emulator ships an embedded mode that developers instantiate directly inside their test process and wire into the SDK through its HTTP client. Each embedded instance keeps its own state, so tests do not share buckets, tables, or queues, and developers can run many of them in parallel.

Fidelity and limitations

The service addresses a growing problem for developers: testing increasingly complex cloud applications quickly and repeatedly without the cost and operational overhead of deploying them to the cloud, said Ashish Chaturvedi, executive research leader at HFS Research. "Developers can test multi-service workflows involving S3, Lambda, DynamoDB, and API Gateway without provisioning anything," Chaturvedi said.

The bigger advantage will be for developers using AI coding agents, according to Advait Patel, senior site reliability engineer at Broadcom. "Agents work in loops: write code, run it, see the error, fix it, repeat. When every loop hits real AWS, you wait on provisioning, you pay for resources, and you clean up whatever the agent forgot to delete," Patel said. Moving that loop to a laptop cuts each cycle from minutes to seconds.

AWS Emulator comes with limitations that could prevent enterprises from relying on it as a substitute for testing against actual cloud infrastructure, according to Devin Pratt, research director at IDC. "At launch, the emulator does not simulate throttling or outages, snapshot and restore, or per-Region availability, which matter most for resilience," Pratt said.

AWS measures the fidelity of the service by comparing API responses with those from actual AWS services and testing whether multi-step workflows behave as expected. Operations that have not been implemented or verified return HTTP 503 errors rather than being treated as successful. Successful tests against the emulator do not necessarily guarantee that applications will behave identically on actual AWS infrastructure, Patel said.

There are security concerns as well, particularly because the emulator does not sandbox the code it executes, according to Pratt. If developers include real production credentials in functions being tested locally, the code could still access actual AWS resources, potentially exposing enterprises to unintended resource access or security risks. The emulator is available for download at no charge, with source code published on GitHub.

Frequently asked questions

What is AWS Emulator?

AWS Emulator is a free, open-source local emulator in Rust that lets developers test applications against nearly every AWS service on their own machine using the same CLI and SDK commands.

How does AWS Emulator work?

Developers install the emulator, start it, and point their tools at a local HTTPS endpoint. It generates its own credentials and config, and developers set environment variables to redirect AWS SDK calls to the laptop.

What are the limitations of AWS Emulator?

At launch, it does not simulate throttling, outages, snapshot and restore, or per-Region availability. Operations not implemented or verified return HTTP 503 errors, and it does not sandbox code it executes.

More from this edition