If you want to run OpenEMM on any other operating system than supported you can use the virtualization software VirtualBox.
We are providing an almost ready to use appliance for easy installation.
To use this appliance you first have to install VirtualBox (supported) or any other virtualization software which supports the open virtualization format to import a virtual machine.
You can download the latest version here: https://www.virtualbox.org/wiki/Downloads
You can install VirtualBox from the repositories provides by your OS.
On Ubuntu you can install it with
sudo apt install virtualbox
If you need the latest version or your OS does not provide packages you can download it here: https://www.virtualbox.org/wiki/Linux_Downloads
Download the appliance from our website: https://www.agnitas.de/en/download/openemm-ova/
Now you can start VirtualBox.
After starting VirtualBox, click on File, Import Appliance and select the downloaded .ova file. Then click on Next.
In this menu you can edit the settings for this virtual machine, but the default settings are sufficient for the beginning.
If you change the network adapter settings, please make sure that after your changes it is still in bridged mode for best functionality.
When you are happy with the settings click on Import.
Now you can start the virtual machine by selecting it and clicking Start.
A terminal will open where you can login for the first time.
Use the user root and the password OpenEMM.
You will be asked to change this password immediately.
An IP address will be automatically assigned using DHCP. If you have to set up an IP address manually edit the file /etc/sysconfig/network-scripts/ifcfg-enp0s3.
BOOTPROTO=static IPADDRESS=<your IP> PREFIX=<your network prefix> GATEWAY=<your network gateway> DNS1=<your dns server>
You can see the current IP address with the command
Now switch to user openemm with
su - openemm
Please mind the default credentials for the database:
User root password OpenEMM
User openemm password OpenEMM
Run the OpenEMM Maintenance Tool (OMT) with
You can now continue the configuration of OpenEMM with the OpenEMM Install & Admin Guide at chapter 5 OpenEMM Deployment → Configuration.
The Install & Admin Guide is available at the main page.
Please do not forget to update your systems hostname or optionally set parameter myhostname in postfix's main.cf configuration file to your FQDN.