MDriven Server and MDriven Turnkey Installation on macOS Ventura - 13.77 (Intel Chip)
This guide provides step-by-step instructions to install and configure MDriven Server and MDriven Turnkey on macOS Ventura (Intel-based Macs).
â ď¸ Important Notice on macOS Ventura Installation
While the step-by-step guide enables successful installation of MDriven Server on macOS Ventura (Intel chip), it is important to note that MDriven Turnkey and MDriven Designer currently do not install or run reliably on this platform.
MDriven technology is not officially supported on macOS by the MDriven team. As such, some components may not work as expected, and certain functionality may be unavailable.
This guide is provided as a community contribution to document what works and where limitations exist. Users who require full functionality are encouraged to consider supported environments (e.g., Windows or Linux) for production deployments.
Step 1: Install Homebrew
Open Terminal and run the following command to install Homebrew (if not already installed):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Step 2: Install .NET SDK 8.0
Use Homebrew to install the .NET SDK:
brew install --cask dotnet-sdk@8
Verify installation:
dotnet --list-runtimes
Step 3: Install Apache
Please skip this section unless you want to serve up MDriven with Apache - this config file doesnt include the steps for this part Install Apache web server using Homebrew:
brew install httpd
Start Apache:
brew services start httpd
Check status by opening http://127.0.0.1:8080 in your browser.
Step 4: Download MDriven Server
Download the latest MDriven Server package:
wget https://www.mdriven.net/PublicDownloads/MDrivenServerCoreLinux_20241219.zip
Unzip the file into /usr/local/var/www/MDrivenServer:
mkdir -p /usr/local/var/www/MDrivenServerunzip MDrivenServerCoreLinux_20241219.zip -d /usr/local/var/www/MDrivenServer
Step 5: Download MDriven Turnkey
Download the latest MDriven Turnkey package:
wget https://www.mdriven.net/PublicDownloads/MDrivenTurnkeyCoreLinux_20241219.zip
Unzip the file into /usr/local/var/www/MDrivenTurnkey:
mkdir -p /usr/local/var/www/MDrivenTurnkeyunzip MDrivenTurnkeyCoreLinux_20241219.zip -d /usr/local/var/www/MDrivenTurnkey
Step 6: Create Launchd Service for MDriven Server
Create a property list file at /Library/LaunchDaemons/com.mdriven.server.plist with the following content:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.mdriven.server</string>
<key>ProgramArguments</key>
<array>
<string>/usr/local/share/dotnet/dotnet</string>
<string>/usr/local/var/www/MDrivenServer/AppCompleteGenericCore.dll</string>
<string>-port=5010</string>
<string>--nohttps</string>
</array>
<key>WorkingDirectory</key>
<string>/usr/local/var/www/MDrivenServer</string>
<key>EnvironmentVariables</key>
<dict>
<key>DOTNET_ENVIRONMENT</key>
<string>Production</string>
<key>DOTNET_PRINT_TELEMENTRY_MESSAGE</key>
<string>false</string>
</dict>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<true/>
<key>StandardOutPath</key>
<string>/var/log/mdriven-server.log</string>
<key>StandardErrorPath</key>
<string>/var/log/mdriven-server-error.log</string>
</dict>
</plist>
Set permissions:
sudo chown root:wheel /Library/LaunchDaemons/com.mdriven.server.plistsudo chmod 644 /Library/LaunchDaemons/com.mdriven.server.plist
Load the service:
sudo launchctl load /Library/LaunchDaemons/com.mdriven.server.plist
Step 7: Create Launchd Service for MDriven Turnkey
Create a property list file at /Library/LaunchDaemons/com.mdriven.turnkey.plist with the following content:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.mdriven.turnkey</string>
<key>ProgramArguments</key>
<array>
<string>/usr/local/share/dotnet/dotnet</string>
<string>/usr/local/var/www/MDrivenTurnkey/StreaminAppCoreWebApp.dll</string>
<string>-port=5011</string>
<string>--nohttps</string>
</array>
<key>WorkingDirectory</key>
<string>/usr/local/var/www/MDrivenTurnkey</string>
<key>EnvironmentVariables</key>
<dict>
<key>DOTNET_ENVIRONMENT</key>
<string>Production</string>
<key>DOTNET_PRINT_TELEMENTRY_MESSAGE</key>
<string>false</string>
</dict>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<true/>
<key>StandardOutPath</key>
<string>/var/log/mdriven-turnkey.log</string>
<key>StandardErrorPath</key>
<string>/var/log/mdriven-turnkey-error.log</string>
</dict>
</plist>
Set permissions:
sudo chown root:wheel /Library/LaunchDaemons/com.mdriven.turnkey.plistsudo chmod 644 /Library/LaunchDaemons/com.mdriven.turnkey.plist
Load the service:
sudo launchctl load /Library/LaunchDaemons/com.mdriven.turnkey.plist
Step 8: Verify and Access Services
Check if the services are running:
$ dotnet /usr/local/var/www/MDrivenServer/MDrivenServerCoreLinux_20250829/AppCompleteGenericCore.dll -port=5010 --nohttps
This is MDriven Server, 2025-08-29 05:09
Leave this window open to keep the server running
http://services:5010
useIIS: False
Hosting environment: Development
Content root path: /usr/local/var/www/MDrivenServer/MDrivenServerCoreLinux_20250829
Now listening on: http://[::]:5010
Application started. Press Ctrl+C to shut down.
MDriven Turnkey commandline command to use
$ dotnet /usr/local/var/www/MDrivenTurnkey/MDrivenTurnkeyCoreLinux_20250829/StreaminAppCoreWebApp.dll -port=5011 --nohttps
Search for the MDriven Service
sudo launchctl list | grep mdriven
Access the services in your browser:
MDriven Server: http://localhost:5010
MDriven Turnkey: http://localhost:5011