Ministack — Free Open-Source Local AWS Emulator

Introduction

Ministack is a free, open-source local AWS emulator that lets developers run cloud services on their own machines. It supports over 60 AWS services with Terraform compatibility, making it practical for local development, integration testing, and CI pipelines without incurring cloud costs.

What Ministack Does

• Emulates 60+ AWS services including S3, Lambda, DynamoDB, SQS, SNS, and EC2
• Provides Terraform-compatible endpoints for infrastructure-as-code workflows
• Runs real database engines rather than mocked stubs for higher fidelity
• Supports the standard AWS SDK and CLI through local endpoints
• Offers a web dashboard for browsing and managing emulated resources

Architecture Overview

Ministack runs as a Python-based service that spins up emulated AWS API endpoints on localhost. Each service is implemented as a plugin that handles API requests in the AWS request format. For data services, it uses real database engines (SQLite, PostgreSQL) rather than in-memory mocks, providing more accurate behavior during testing.

Self-Hosting & Configuration

• Install via pip or run with Docker for isolated environments
• Configure which services to enable through environment variables or a config file
• Set custom ports for each service endpoint to avoid conflicts
• Integrate with Terraform by pointing provider endpoints to localhost
• Use in CI pipelines by starting Ministack as a service container

Key Features

• 60+ AWS service emulations in a single lightweight package
• Real database backends instead of simple mocks for data services
• Full Terraform and AWS SDK compatibility out of the box
• MIT licensed and completely free with no usage tiers or limits
• Web dashboard for visual resource management and inspection

Comparison with Similar Tools

• LocalStack — the established AWS emulator; Ministack is fully MIT-licensed and free
• Moto — Python library for mocking AWS in tests; Ministack provides running endpoints
• AWS SAM Local — limited to Lambda and API Gateway; Ministack covers 60+ services
• ElasticMQ — SQS-only emulator; Ministack bundles many services together
• MinIO — S3-compatible storage only; Ministack emulates the full AWS surface

FAQ

Q: Is Ministack a drop-in replacement for LocalStack? A: It covers similar ground with a focus on being completely free and open-source under MIT license. API compatibility varies by service.

Q: Can I run production workloads on Ministack? A: No. It is designed for local development and testing only, not production traffic.

Q: Does it support AWS IAM policies? A: Basic IAM emulation is supported for authentication flows, but full policy evaluation may differ from real AWS.

Q: How does it compare in resource usage? A: Ministack is designed to be lightweight, running comfortably on a developer laptop with 4GB of RAM.

Sources

• https://github.com/ministackorg/ministack
• https://ministack.cloud