Docker Compose scripts and docs

Author: crivetimihai

docs/docs/deployment/compose.md

@@ -108,6 +108,33 @@ Named volumes (`pgdata`, `mariadbdata`, `mysqldata`, `mongodata`) isolate persis
 
 ---
 
+````markdown
+---
+
+## 🔍 Troubleshooting port publishing on WSL2 (rootless Podman)
+
+```bash
+# Verify the port is listening (dual-stack)
+ss -tlnp | grep 4444        # modern tool
+netstat -anp | grep 4444    # legacy fallback
+````
+
+> A line like `:::4444 LISTEN rootlessport` is **normal** – the IPv6
+> wildcard socket (`::`) also accepts IPv4 when `net.ipv6.bindv6only=0`
+> (the default on Linux).
+
+**WSL2 quirk**
+
+WSL's NAT maps only the IPv6 side, so `http://127.0.0.1:4444` fails from Windows. Tell Podman you are inside WSL and restart your containers:
+
+```bash
+# inside the WSL distro
+echo "wsl" | sudo tee /etc/containers/podman-machine
+```
+
+`ss` should now show an explicit `0.0.0.0:4444` listener, making the
+service reachable from Windows and the LAN.
+
 ## 📚 References
 
 * Docker Compose CLI (`up`, `logs`, `down`) – official docs
@@ -116,3 +143,5 @@ Named volumes (`pgdata`, `mariadbdata`, `mysqldata`, `mongodata`) isolate persis
 * Health-check gating with `depends_on: condition: service_healthy`
 * [UBI9 runtime on Apple Silicon limitations (`x86_64-v2` glibc)](https://github.com/containers/podman/issues/15456)
 * General Containerfile build guidance (Fedora/Red Hat)
+
+

podman-compose-mcpgateway.yaml

@@ -32,16 +32,16 @@ services:
     # Environment – pick ONE database URL line, comment the rest
     # ──────────────────────────────────────────────────────────────────────
     environment:
-      - HOST="0.0.0.0"
-      - PORT="4444"
+      - HOST=0.0.0.0
+      - PORT=4444
       - DATABASE_URL=postgresql://postgres:${POSTGRES_PASSWORD:-mysecretpassword}@postgres:5432/mcp
       # - DATABASE_URL=mysql+pymysql://mysql:${MYSQL_PASSWORD:-changeme}@mysql:3306/mcp
       # - DATABASE_URL=mysql+pymysql://admin:${MARIADB_PASSWORD:-changeme}@mariadb:3306/mcp
       # - DATABASE_URL=mongodb://admin:${MONGO_PASSWORD:-changeme}@mongodb:27017/mcp
       - REDIS_URL=redis://redis:6379/0
-      - JWT_SECRET_KEY=change-me
+      - JWT_SECRET_KEY=changeme
       - BASIC_AUTH_USER=admin
-      - BASIC_AUTH_PASSWORD=change-me
+      - BASIC_AUTH_PASSWORD=changeme
 
     depends_on:          # Default stack: Postgres + Redis
       postgres: