OX App Suite Server Installation for Dummies

May 3, 2021

OX-generic-image_2021_720x320

Ever wanted to install your own OX App Suite Server, but too lazy to configure a Linux system with all OX App Suite system requirements?

Then this is for you!

All you need to have installed on your machine - which can be a Windows, Mac or Linux system -  are the free tools Vagrant and VirtualBox.

Follow these simple steps:

  • Launch a console / terminal window, create a folder for your vagrant project, and cd into it.
  • Run “vagrant init oxdev/oxappsuite-base”. This will create a vagrant configuration for you.
  • If you have used the oxappsuite-base image before, run “vagrant box update” to make sure you have the latest version
  • Run “vagrant up”. This will download and launch a Linux image where all system requirements like Apache, MySQL, Dovecot and Postfix are installed.
  • Run “vagrant ssh” to ssh into the new system.
  • Run “sudo ./install-appsuite” to install Core OX App Suite.
  • To add OX Documents for editing office documents (text, spreadsheet and presentation):
    • sudo ./install-dcs
    • sudo ./install-documents
  • To add OX Guard for file encryption:
    • sudo ./install-guard

Your new virtual machine is now ready to use, the only thing missing is the network configuration so that you can reach your newly created vm from your host system. Shutdown your vm via “sudo shutdown -h now” and configure the network settings to use port forwarding:

  • Choose Settings / Network / Advanced / Port Forwarding
  • Click the plus sign at the upper right corner
  • For the new rule, set Guest Port to 80, and Host Port to the port that you want to use locally, e.g. 8089

Restart the virtual machine. OX App Suite will launch automatically.

Now you can launch OX App Suite from your host system in the browser: localhost. There are two OX App Suite users configured: david and eva, both with password “secret”.

If you want to make additional changes to your virtual machine, or to the OX App Suite installation: All passwords for MySQL and OX App Suite management are “secret”. For the login, use the user “vagrant” with password “vagrant”, which is a convention for vagrant machines. The vagrant user can do sudo without needing to enter a password.

More information about OX App Suite Installation and Configuration can be found on oxpedia.org.

Disclaimer: The machine that you have just created is for evaluation purpose only. For a production system, make sure to use secure passwords and configurations.

About this article

About the Author

Malte Timmermann

Malte Timmermann

Head of Development OX Hamburg

Categories

Share this article