MiniStack — émulateur AWS local gratuit et open source

• Un émulateur gratuit et open source capable de reproduire entièrement un environnement AWS en local, développé comme alternative à LocalStack devenu payant
• Exécute 34 services AWS sur un port unique et lance réellement des conteneurs Postgres, Redis et Docker pour fournir un environnement de test au niveau infrastructure
• Entièrement compatible avec AWS SDK, CLI, Terraform, CDK, Pulumi, et distribué sous licence MIT sans inscription de compte ni télémétrie
• Démarrage en 2 secondes, 30 Mo de mémoire utilisée, image Docker de 150 Mo pour une exécution locale légère et rapide
• Toutes les fonctionnalités sont proposées gratuitement, ce qui permet de construire un environnement local AWS complet remplaçant les fonctions Pro de LocalStack

---

Présentation de MiniStack

• MiniStack est un outil gratuit et open source capable d’émuler entièrement un environnement AWS en local, conçu comme alternative à LocalStack devenu payant
• Il exécute 34 services AWS sur un port unique et utilise de vrais conteneurs Postgres, Redis et Docker
• Il fonctionne sans inscription de compte, clé de licence ni télémétrie distante, et est distribué sous licence MIT
• Il affiche environ 2 secondes de démarrage, 30 Mo de mémoire au repos et une image Docker de 150 Mo
• Depuis la monétisation de l’édition Community de LocalStack, il est présenté comme une solution de remplacement offrant gratuitement la même expérience de développement

Principales fonctionnalités et services

• RDS, ElastiCache, ECS et d’autres exécutent de vrais conteneurs Docker afin de fournir un environnement d’infrastructure réel
• Athena exécute de vraies requêtes SQL via DuckDB et renvoie des résultats simulés s’il n’est pas installé
• La compatibilité AWS SDK est conservée, ce qui permet l’usage avec boto3, AWS CLI, Terraform, CDK, Pulumi, etc.
• Tous les services sont gratuits, sans limitation fonctionnelle ni séparation entre offres payantes

• Les 34 services AWS inclus

  • S3 : prise en charge des buckets, objets, versioning, chiffrement, cycle de vie, CORS, réplication, etc.
  • SQS : prise en charge des fonctions de file d’attente comme FIFO, DLQ, batch, visibilité, etc.
  • SNS : prise en charge des topics, abonnements, fan-out vers SQS, publication par lot
  • DynamoDB : prise en charge de CRUD, query, scan, transactions, TTL, GSI
  • Lambda : exécution réelle de Python, mappage des événements SQS, prise en charge des Layers
  • IAM / STS / Secrets Manager / CloudWatch / SSM / EventBridge / Kinesis / SES / Step Functions / API Gateway v1·v2 / Route53 / Cognito / EC2 / EMR / EBS / EFS / ALB / ACM / WAF / CloudFormation et la plupart des services AWS essentiels sont inclus
  • RDS lance de vrais conteneurs Postgres/MySQL, et ElastiCache de vrais conteneurs Redis/Memcached
  • ECS exécute de vrais conteneurs Docker, tandis que Glue et Athena fournissent des fonctions de catalogue de données et d’exécution SQL

Comparaison avec LocalStack

• LocalStack Free a rendu payants certains services essentiels, tandis que MiniStack fournit les mêmes fonctionnalités gratuitement
• Des fonctionnalités réservées à LocalStack Pro comme Lambda, IAM, SSM, EventBridge, EC2, EMR, EBS, EFS, ALB, CloudFormation sont aussi incluses gratuitement
• RDS, ElastiCache, ECS, Athena fonctionnent sur une base de vrais conteneurs
• Avec un démarrage d’environ 2 secondes, 30 Mo de mémoire utilisée et une image Docker de 150 Mo, il est bien plus léger que LocalStack
• La licence est MIT au lieu de BSL/propriétaire pour LocalStack, et le prix est entièrement gratuit

Fonctionnement sur infrastructure réelle

• RDS : la commande CreateDBInstance crée un vrai conteneur Docker Postgres/MySQL, accessible directement via un port local
• ElastiCache : la commande CreateCacheCluster exécute un vrai conteneur Redis, exploitable par exemple comme stockage de session
• ECS : la commande RunTask exécute un vrai conteneur Docker et permet de tester localement des définitions de tâches ECS
• Athena : exécute de vraies requêtes SQL via DuckDB et renvoie un jeu de résultats
• Compatibilité complète avec tous les outils AWS, sans changer les endpoints d’API

Déploiement et utilisation

• Exécution possible avec une simple commande Docker

  docker run -p 4566:4566 nahuelnucera/ministack
  

• Tous les services comme S3, RDS, ElastiCache, etc. sont accessibles via AWS CLI
• Exemples :
  • aws --endpoint-url=http://localhost:4566 s3 mb s3://my-bucket
  • aws --endpoint-url=http://localhost:4566 rds create-db-instance --engine postgres
  • aws --endpoint-url=http://localhost:4566 elasticache create-cache-cluster --engine redis

Licence et informations de diffusion

• Distribué sous licence MIT, il peut être librement forké et embarqué
• Disponible publiquement sur GitHub et Docker Hub
• Le développeur est Nahuel, et le projet devrait être maintenu jusqu’en 2026

Enseignement clé

• MiniStack est une alternative totalement gratuite à LocalStack, offrant un environnement AWS local basé sur une vraie infrastructure
• Il se distingue par son démarrage rapide, sa faible consommation de ressources et sa compatibilité SDK complète
• Toutes les fonctionnalités sont gratuites, sous licence MIT, et sans télémétrie
• C’est un outil qui offre en local et en CI/CD la même expérience de test qu’un environnement AWS de production