Skip to content

Ministack: Free, open-source local AWS emulator - 60+ services, Terraform compatible, real databases. Free forever. MIT licensed.

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.md
index 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/Dockerfile
index 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=1
diff --git a/README.md b/README.md
index 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.py
index 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.id
logger.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.toml
index 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" }