View source for HowTos:Deploying on MacOs

<nutshell> 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. </nutshell>

== 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).<syntaxhighlight>
⚠️ 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.
</syntaxhighlight>

== Step 1: Install Homebrew ==
Open Terminal and run the following command to install Homebrew (if not already installed):<syntaxhighlight>
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
</syntaxhighlight>

== Step 2: Install .NET SDK 8.0 ==
Use Homebrew to install the .NET SDK:<syntaxhighlight>
brew install --cask dotnet-sdk@8
</syntaxhighlight>Verify installation:<syntaxhighlight>
dotnet --list-runtimes
</syntaxhighlight>

== 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:<syntaxhighlight>
brew install httpd

Start Apache:

brew services start httpd
</syntaxhighlight>Check status by opening <nowiki>http://127.0.0.1:8080</nowiki> in your browser.

== Step 4: Download MDriven Server ==
Download the latest MDriven Server package:<syntaxhighlight lang="bash">
$ wget https://www.mdriven.net/PublicDownloads/MDrivenServerCoreLinux_20241219.zip
</syntaxhighlight>Unzip the file into /usr/local/var/www/MDrivenServer:<syntaxhighlight lang="bash">
$ mkdir -p /usr/local/var/www/MDrivenServerunzip MDrivenServerCoreLinux_20241219.zip -d /usr/local/var/www/MDrivenServer
</syntaxhighlight>

== Step 5: Download MDriven Turnkey ==
Download the latest MDriven Turnkey package:<syntaxhighlight lang="bash">
$ wget https://www.mdriven.net/PublicDownloads/MDrivenTurnkeyCoreLinux_20241219.zip
</syntaxhighlight>Unzip the file into /usr/local/var/www/MDrivenTurnkey:<syntaxhighlight lang="bash">
$ mkdir -p /usr/local/var/www/MDrivenTurnkeyunzip MDrivenTurnkeyCoreLinux_20241219.zip -d /usr/local/var/www/MDrivenTurnkey
</syntaxhighlight>

== Step 6: Create Launchd Service for MDriven Server ==
Create a property list file at /Library/LaunchDaemons/com.mdriven.server.plist with the following content:<syntaxhighlight lang="xml">
<?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>
</syntaxhighlight>Set permissions:<syntaxhighlight lang="bash">
$ sudo chown root:wheel /Library/LaunchDaemons/com.mdriven.server.plistsudo chmod 644 /Library/LaunchDaemons/com.mdriven.server.plist
</syntaxhighlight>Load the service:<syntaxhighlight lang="bash">
$ sudo launchctl load /Library/LaunchDaemons/com.mdriven.server.plist
</syntaxhighlight>

== Step 7: Create Launchd Service for MDriven Turnkey ==
Create a property list file at /Library/LaunchDaemons/com.mdriven.turnkey.plist with the following content:<syntaxhighlight lang="xml">
<?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>
</syntaxhighlight>Set permissions:<syntaxhighlight lang="bash">
$ sudo chown root:wheel /Library/LaunchDaemons/com.mdriven.turnkey.plistsudo chmod 644 /Library/LaunchDaemons/com.mdriven.turnkey.plist
</syntaxhighlight>Load the service:<syntaxhighlight lang="bash">
$ sudo launchctl load /Library/LaunchDaemons/com.mdriven.turnkey.plist
</syntaxhighlight>

== Step 8: Verify and Access Services ==
Check if the services are running:<syntaxhighlight lang="bash" line="1">
$ 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.


</syntaxhighlight>MDriven Turnkey commandline command to use<syntaxhighlight>
$ dotnet /usr/local/var/www/MDrivenTurnkey/MDrivenTurnkeyCoreLinux_20250829/StreaminAppCoreWebApp.dll -port=5011 --nohttps     


</syntaxhighlight>Search for the MDriven Service <syntaxhighlight lang="bash">
$ sudo launchctl list | grep mdriven
</syntaxhighlight>Access the services in your browser:<syntaxhighlight>
MDriven Server: http://localhost:5010

MDriven Turnkey: http://localhost:5011
</syntaxhighlight>

[[Category:Deploying on MacOS]]
[[Category:Deployment]]

[[Category:HowTos]]

[[Category:Installation and Deployment]]