OX App Suite Server Installation for Dummies

May 3, 2021


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 the author

Malte Timmermann

Malte Timmermann

Head of Development OX Hamburg


Related Articles

OX App Suite Software Subscription v8 – Delivering a better...

For over 15 years Open-Xchange has led the market in hosted email solutions, right from when we released our first real SaaS...

Jan Tran Nov 29, 2023

Customer Focus: Yvan Knapp, Chief Strategy Officer at Hostpoint

Hostpoint has been shaping the internet in Switzerland since 2001 and is now the country’s largest web hosting provider and...

Chris Holder Oct 5, 2023

OX App Suite Server Installation for Dummies

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

Malte Timmermann May 3, 2021

New versions of OX App Suite, OX Documents and OX Guard available

We are pleased to announce the release of new versions of three of our products: Both our messaging and collaboration...

Benjamin Otterbach Feb 10, 2021