Running MDriven Locally with Docker
Created by Charles on 2026-01-29 · Last edited by Charles on 2026-01-29.
This setup is designed for developers who need a quick, reliable MDriven environment on their local machine. It supports Windows, Linux, and macOS on standard Intel/AMD processors, Apple Silicon (M1/M2/M3), and Alpine Linux.
1. Download the Setup
Download the zip file matching your computer's processor or distribution:
- For Apple Silicon (M1/M2/M3) or ARM Linux: Download Local ARM64 Config
- For Standard Intel/AMD (Windows, Linux, Intel Macs): Download Local AMD64 Config
- For Alpine Linux (Musl): Download Local Musl Config
2. Setup Instructions
- Extract the Zip: Unzip the downloaded file to a folder (e.g., mdriven-local).
- Open Terminal: Navigate to that folder in your terminal (PowerShell on Windows, Terminal on macOS/Linux).
- Start Services: Run the following command:
docker compose up -d
3. Verify Installation
Once the containers are running, you can access your local MDriven instance:
- MDriven Server: http://localhost:5011 (Check compose.yaml for exact port)
- Turnkey App: http://localhost:5012
4. Troubleshooting
- Port Conflicts: If you see an error about "Bind for 0.0.0.0:5011 failed", another app is using that port. Open
compose.yamland change the port mapping (e.g.,"5013:5011"). - Apple Silicon Users: If you downloaded the wrong architecture (AMD64 on an M1 Mac), the containers may crash with an
exec format error. Ensure you used the ARM64 link above.
