🚀 Welcome to MDriven Learn –  MDriven is now on Discord!  Don’t miss the latest Release Notes.
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:

2. Setup Instructions

  1. Extract the Zip: Unzip the downloaded file to a folder (e.g., mdriven-local).
  2. Open Terminal: Navigate to that folder in your terminal (PowerShell on Windows, Terminal on macOS/Linux).
  3. 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.yaml and 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.


< Back to Docker Overview