MiniStack: A High-Performance, Open-Source Alternative to LocalStack for AWS Emulation

Ministack, the best alternative to Localstack

Nahuel Nucera introduced MiniStack as a response to LocalStack moving core services behind a paywall. The system emulates 30 AWS services with a 2-second startup time and 30MB idle RAM footprint.

Why This Matters

Local development often suffers when cloud emulators stub responses instead of running actual infrastructure, leading to ‘works on my machine’ failures. MiniStack addresses this by spinning up real containers for RDS, Redis, and ECS, ensuring that the local environment mirrors production logic without the cost or latency of live AWS resources.

Key Insights

• MiniStack supports 30 AWS services including EC2, Cognito, and EMR which are often gated behind paywalls in other emulators (Nahuel Nucera, 2026).
• Real infrastructure execution: RDS uses actual Postgres/MySQL containers and Athena executes SQL via DuckDB rather than using fake endpoints.
• Resource efficiency: The emulator maintains an idle footprint of approximately 30MB RAM and uses a single port (4566) for all service communications.
• Integration reliability: The project includes over 600 integration tests and is released under the MIT license for full transparency and community contribution.

Working Examples

Standard initialization and bucket creation using the MiniStack endpoint.

docker run -p 4566:4566 nahuelnucera/ministack
aws --endpoint-url=http://localhost:4566 s3 mb s3://my-bucket

Practical Applications

• Use case: CI/CD pipelines can utilize MiniStack to run integration tests for EC2 networking and ALB configurations without incurring AWS costs. Pitfall: Hardcoding endpoint URLs instead of using environment variables, which prevents seamless switching between local and cloud environments.
• Use case: Developers building identity-aware applications can use the free Cognito user pools for local authentication testing. Pitfall: Assuming local emulator performance exactly matches AWS throughput, which can lead to missed race conditions during high-load production scenarios.

References:

• https://github.com/Nahuel990/ministack
• https://ministack.org
• https://dev.to/nahuel990/ministack-the-best-alternative-to-localstack-4553