Ministack: Free, open-source local AWS emulator - 60+ services, Terraform compatible, real databases. Free forever. MIT licensed.
Python awsaws-emulatoraws-localaws-sdkdevtoolsdockerdynamodbec2emulatorlambdalocalstacklocalstack-alternativeministackmock-awsopen-sourcepythons3sqsterraform
feat(rds): add RDS_PERSIST env var for dynamic volume storage + dual Docker Hub publishing (#248) (#248)
Nahuel Nucera212428d9fb28
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex d05733d2..6f6d4ffc 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -7,6 +7,14 @@ Versioning follows [Semantic Versioning](https://semver.org/).---+## [1.2.1] — 2026-04-11++### Added+- **Dynamic RDS storage** — new `RDS_PERSIST=1` env var switches database containers from fixed-size tmpfs to Docker named volumes for auto-growing persistent storage. Default (`RDS_PERSIST=0`) remains ephemeral tmpfs for CI/CD. Reported by @macario1983 (#248).+- **Dual Docker Hub publishing** — Docker images now publish to both `nahuelnucera/ministack` and `ministackorg/ministack` on tag push.++---+## [Unreleased]---diff --git a/Dockerfile b/Dockerfileindex 5ddbf1dd..1c11f852 100644--- a/Dockerfile+++ b/Dockerfile@@ -32,6 +32,7 @@ ENV GATEWAY_PORT=4566 \REDIS_HOST=redis \REDIS_PORT=6379 \RDS_BASE_PORT=15432 \+ RDS_PERSIST=0 \ELASTICACHE_BASE_PORT=16379 \LAMBDA_EXECUTOR=local \PYTHONUNBUFFERED=1diff --git a/README.md b/README.mdindex e26a7f9a..d78d3cf9 100644--- a/README.md+++ b/README.md@@ -592,7 +592,8 @@ ecs.stop_task(cluster="dev", task=task_arn)| `REDIS_HOST` | `redis` | Redis host for ElastiCache fallback || `REDIS_PORT` | `6379` | Redis port for ElastiCache fallback || `RDS_BASE_PORT` | `15432` | Starting host port for RDS containers |-| `RDS_TMPFS_SIZE` | `256m` | Tmpfs size for RDS database containers. Set to `2g` or higher for large databases |+| `RDS_TMPFS_SIZE` | `256m` | Tmpfs size for RDS database containers (when `RDS_PERSIST=0`). Set to `2g` or higher for large databases |+| `RDS_PERSIST` | `0` | Set `1` to use Docker named volumes for RDS containers instead of tmpfs. Storage grows dynamically with no fixed cap || `ELASTICACHE_BASE_PORT` | `16379` | Starting host port for ElastiCache containers || `PERSIST_STATE` | `0` | Set `1` to persist service state across restarts || `STATE_DIR` | `/tmp/ministack-state` | Directory for persisted state files |diff --git a/ministack/services/rds.py b/ministack/services/rds.pyindex 8a0aba3d..bf3847e1 100644--- a/ministack/services/rds.py+++ b/ministack/services/rds.py@@ -39,6 +39,7 @@ logger = logging.getLogger("rds")REGION = os.environ.get("MINISTACK_REGION", "us-east-1")BASE_PORT = int(os.environ.get("RDS_BASE_PORT", "15432"))RDS_TMPFS_SIZE = os.environ.get("RDS_TMPFS_SIZE", "256m")+RDS_PERSIST = os.environ.get("RDS_PERSIST", "0").lower() in ("1", "true", "yes")_instances = AccountScopedDict()_clusters = AccountScopedDict()@@ -181,15 +182,24 @@ def _create_db_instance(p):)if image:try:- container = docker_client.containers.run(- image, detach=True,+ container_kwargs = dict(+ image=image, detach=True,environment=env,ports={f"{container_port}/tcp": host_port},name=f"ministack-rds-{db_id}",labels={"ministack": "rds", "db_id": db_id},- tmpfs={"/var/lib/postgresql/data": f"rw,noexec,nosuid,size={RDS_TMPFS_SIZE}",- "/var/lib/mysql": f"rw,noexec,nosuid,size={RDS_TMPFS_SIZE}"},)+ if RDS_PERSIST:+ container_kwargs["volumes"] = {+ f"ministack-rds-{db_id}-data": {"bind": "/var/lib/postgresql/data", "mode": "rw"},+ f"ministack-rds-{db_id}-mysql": {"bind": "/var/lib/mysql", "mode": "rw"},+ }+ else:+ container_kwargs["tmpfs"] = {+ "/var/lib/postgresql/data": f"rw,noexec,nosuid,size={RDS_TMPFS_SIZE}",+ "/var/lib/mysql": f"rw,noexec,nosuid,size={RDS_TMPFS_SIZE}",+ }+ container = docker_client.containers.run(**container_kwargs)docker_container_id = container.idlogger.info("RDS: started %s container for %s on port %s", engine, db_id, host_port)except Exception as e:diff --git a/pyproject.toml b/pyproject.tomlindex 3dab5456..915eba08 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"[project]name = "ministack"-version = "1.2.0"+version = "1.2.1"description = "Free, open-source local AWS emulator — drop-in LocalStack replacement"readme = "README.md"license = { file = "LICENSE" }