HowTos:Deploying on macOS

Deploying on macOS

This guide provides detailed steps to install and configure MDriven Server and MDriven Turnkey on macOS Ventura (Intel-based Macs). It highlights that while MDriven Server can be installed successfully, MDriven Turnkey and MDriven Designer may not run reliably on this platform, as MDriven is not officially supported on macOS. Users are advised to use supported environments like Windows or Linux for full functionality. The guide includes instructions for installing Homebrew, .NET SDK, and Apache, downloading and setting up MDriven packages, creating launch services, and verifying service operation.

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