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 preferred Linux distribution and computer's processor:

• Ubuntu (Recommended for general use):
  • Download Ubuntu AMD64 (For standard Windows/Linux PCs)
  • Download Ubuntu ARM64 (For Apple Silicon M1/M2/M3 Macs)
• Debian (For highly stable testing):
  • Download Debian AMD64
  • Download Debian ARM64
• Alpine (Minimal / Lightweight footprint):
  • Download Alpine AMD64

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. Configuration Settings

You can easily customize your local setup—such as updating the app versions, lowering container permissions, or resetting the administrator password—by adjusting environment variables and bindings within your compose.yaml file.

Please refer to the Docker Compose Configuration Settings section on the Docker Overview Page for detailed instructions on using UPDATE_APP, PUID/PGID, and the PwdReset.txt file.

5. 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