MDriven Installation on Ubuntu 24.04
MDriven empowers businesses and developers to build and manage applications faster and smarter through Model-Driven Development (MDD). It bridges the gap between business needs and technical execution, turning models into fully functional applications with ease.
With MDriven you can:
- Accelerate development
- Adapt quickly
- Collaborate easily
- Deploy anywhere
Step -1: Login to the Ubuntu Server via SSH
ssh username@IP_Address -p Port_number
Connect via SSH to your server.
Step -2: Update Server
sudo apt-get update
sudo apt-get upgrade
Step -3: Secure Server
sudo apt-get install openssh-server fail2ban
SSH assault can be avoided by utilizing Fail2ban.
Step -4: Install Packages and Libraries
Install apt-transport-https
sudo apt-get install -y apt-transport-https
This ensures you can safely fetch packages, package metadata and add third-party repositories using HTTPS, ensuring data integrity and privacy during downloads.
Add the Microsoft Package Repository
The Microsoft package repository must be added before installing the .NET SDK. Without the repository, the apt install dotnet command may fail because the package cannot be found.
Run the following commands:
sudo apt-get update
sudo apt-get install -y wget ca-certificates
wget https://packages.microsoft.com/config/debian/12/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb
sudo apt-get update
sudo apt-get install -y dotnet-sdk-8.0
Install the .NET SDK version 8.0 or Higher
The command above installs the .NET SDK version 8.0.
This contains the software development kit (SDK) for building and running applications using the .NET platform. What it does:
It includes tools such as the .NET CLI (Command Line Interface), compilers, and build tools needed to develop, build, and publish .NET applications.
It also installs the .NET runtime.
Multi-Language Support - C#, F# and VB.NET.
Cross-Platform Development.
Check that the install is successful:
dotnet --list-runtimes
Install Nginx or Apache Server
Let's go with Nginx Server for now using the following command:
sudo apt install nginx
You can verify if Nginx is running by checking its service status:
sudo systemctl status nginx
The output should show the service as active (running).
Step -5: Download MDriven Server from Official Site
The command below downloads files from the web. Use it to download the latest version of MDriven Server from the main site.
wget https://downloads.mdriven.net/releases/MDrivenServerCoreLinux_20260721.zip
Or download from the main website:
https://mdriven.net/App#/Downloads/
Notes:
Double-check the latest name of the MDriven Server .zip file compatible with Linux from the main site.
Upon download, the downloaded .zip file will be located in your home root directory.
Step -6: Create a Directory in /var/www/html
cd /var/www/html
sudo mkdir mdrivenserver
Unzip the files into the directory. Change to your home directory using the command cd.
cd
sudo unzip MDrivenServerCoreLinux_20260721.zip -d /var/www/html/mdrivenserver
Notes: If the unzip utility is not installed, you can install it with:
sudo apt-get install -y unzip
Step -7: Download MDriven Turnkey Server from the Official Site
The command below downloads files from the web. Use it to download the latest version of MDriven Turnkey from the main site.
wget https://downloads.mdriven.net/releases/MDrivenTurnkeyCoreLinux_20260721.zip
Or download from the main website:
https://mdriven.net/App#/Downloads/
Notes:
Double-check the latest name of the MDriven Turnkey .zip file compatible with Linux from the main site.
Upon download, the downloaded .zip file will be located in your home root directory.
Step -8: Create a Directory in /var/www/html
cd /var/www/html
sudo mkdir mdriventurnkey
Unzip the files into the directory. Change to your home directory using the command cd.
cd
sudo unzip MDrivenTurnkeyCoreLinux_20260721.zip -d /var/www/html/mdriventurnkey
Step -9: Create MDriven Server Service File
We have to create a service file for MDriven Server. Let's create a service file named mdrivenserver.service in /etc/systemd/system.
sudo nano /etc/systemd/system/mdrivenserver.service
Add the following aspects to the newly created service file:
[Unit]
Description=MDriven Server Service
After=network.target
[Service]
WorkingDirectory=/var/www/html/mdrivenserver
ExecStart=/usr/bin/dotnet /var/www/html/mdrivenserver/AppCompleteGenericCore.dll -port=5010 -nohttps
Restart=always
KillSignal=SIGINT
SyslogIdentifier=mdriven-server
User=root
Environment=DOTNET_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMENTRY_MESSAGE=false
[Install]
WantedBy=multi-user.target
Step -10: Create MDriven Turnkey Service File
We have to create a service file for MDriven Turnkey. Let's create a service file named mdriventurnkey.service in /etc/systemd/system.
sudo nano /etc/systemd/system/mdriventurnkey.service
Add the following aspects to the newly created service file:
[Unit]
Description=MDriven Turnkey Server Service
After=network.target
[Service]
WorkingDirectory=/var/www/html/mdriventurnkey
ExecStart=/usr/bin/dotnet /var/www/html/mdriventurnkey/StreaminAppCoreWebApp.dll -port=5011 -nohttps
Restart=always
KillSignal=SIGINT
SyslogIdentifier=turnkey-server
User=root
Environment=DOTNET_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMENTRY_MESSAGE=false
[Install]
WantedBy=multi-user.target
Finally, set the root user's permissions for these service files.
sudo chmod 775 /etc/systemd/system/mdrivenserver.service
sudo chown root: /etc/systemd/system/mdrivenserver.service
sudo chmod 775 /etc/systemd/system/mdriventurnkey.service
sudo chown root: /etc/systemd/system/mdriventurnkey.service
Configure MDrivenServerOverride.xml
MDriven Turnkey uses the MDrivenServerOverride.xml file to connect to a running MDriven Server.
The file is located in the Turnkey installation's App_Data directory.
Open the override file using Nano:
sudo nano /var/www/html/mdriventurnkey/App_Data/MDrivenServerOverride.xml
Configure the override file so that MDriven Turnkey points to the running MDriven Server instance on port 5010.
When MDriven Server and MDriven Turnkey are running on the same Ubuntu server, use:
http://localhost:5010
When MDriven Server is running on another server, replace localhost with the server's IP address or domain name:
http://MDRIVEN_SERVER_IP_OR_DOMAIN:5010
Make sure the username, password and MDriven Server address inside MDrivenServerOverride.xml match the settings configured on the running MDriven Server.
After editing the file, restart MDriven Turnkey:
sudo systemctl restart mdriventurnkey.service
Check the service status:
sudo systemctl status mdriventurnkey.service
Step -11: Run MDriven Server and MDriven Turnkey
Before starting the services, reload systemd so that it recognizes the newly created service files:
sudo systemctl daemon-reload
Start MDriven Server and MDriven Turnkey:
sudo systemctl start mdrivenserver.service
sudo systemctl start mdriventurnkey.service
Use the above commands to launch the instance of MDriven Server and MDriven Turnkey respectively.
Then, use the following commands to see the services' current status. The installation of MDriven Server and MDriven Turnkey was successful if they are shown as active.
sudo systemctl status mdrivenserver.service
sudo systemctl status mdriventurnkey.service
Now, you can access MDriven Server and MDriven Turnkey by entering the following URLs respectively:
http://<your_domain_or_IP_address>:5010
http://<your_domain_or_IP_address>:5011
Ensure that these ports are open on the firewall using the following commands:
sudo ufw allow 5010/tcp
sudo ufw allow 5011/tcp
Check Logs
If you are experiencing problems with the installation or for any other reason, you can use the following commands to examine the logs of the MDriven platform that you have configured.
You can view the real-time logs in the terminal for both MDriven Server and MDriven Turnkey using the commands below.
MDriven Server
sudo tail -f /var/www/html/mdrivenserver/Logs/MDrivenServerRollingDEBUG.txt
sudo tail -f /var/www/html/mdrivenserver/Logs/MDrivenServerLogRollingERRORS.txt
MDriven Turnkey
sudo tail -f /var/www/html/mdrivenserver/Logs/MDrivenServerRollingDEBUG.txt
sudo tail -f /var/www/html/mdriventurnkey/Logs/TurnkeyServerRollingDEBUG.txt
Finally, use the following commands to start MDriven Server and MDriven Turnkey services automatically after restarting the server:
sudo systemctl enable mdrivenserver.service
sudo systemctl enable mdriventurnkey.service
After successfully installing MDriven Server and MDriven Turnkey, you can start your career in modeling with MDriven.
The MDriven installation can also be served with Nginx as a proxy server.
To learn more, read the MDriven wiki page:
Serving MDriven using Nginx as a Proxy