docs: add section about minimal docker images (#1001)

Author: glauberfc

packages/docs/content/docs/deployment-guide/self-hosted.mdx

@@ -175,6 +175,36 @@ Open [http://localhost:3000](http://localhost:3000) - your app should be running
 
 ---
 
+## Troubleshooting
+
+### Using Minimal Docker Images (node:24-slim)
+
+If you're using a minimal Docker image like `node:24-slim` instead of the official `motiadev/motia:latest` image, you may encounter errors when creating a new Motia project or running `motia dev`, 
+because the `redis-memory-server` package may require build tools (`make`, `gcc`, etc.) to compile Redis from source. These are not included in minimal images.
+
+**Solution:** Install the required dependencies before running Motia:
+
+```bash
+docker run --rm node:24-slim bash -c "
+  apt-get update && apt-get install -y ca-certificates git build-essential &&
+  npx motia@latest create my-app --template starter-typescript
+"
+```
+
+**Alternative:** Install Redis system package to avoid compilation:
+
+```bash
+docker run --rm node:24-slim bash -c "
+  apt-get update && apt-get install -y ca-certificates git redis-server &&
+  export REDISMS_SYSTEM_BINARY=/usr/bin/redis-server &&
+  npx motia@latest create my-app --template starter-typescript
+"
+```
+
+**Recommended:** Use the official `motiadev/motia:latest` image which includes all required dependencies, or use the full `node:24` image instead of `node:24-slim`.
+
+---
+
 ## Deploy to Cloud
 
 ### AWS Lightsail