Categories Tutorials

How to install and configure eXo Platform with Java and Apache as a reverse proxy

EXo Platform is an open source software written in Java which allow developers to build a modern social intranets, business portals with complete collaborative and content management features, websites, forums, wikis, workflows, work-spaces, activity streams and more – all in one single platform. The content can easily be aggregated in a secure and customizable way.

In this step-by-step tutorial, we will show you how to easily install eXo Platform on a Linux based virtual server.

In order to run eXo Platform, Java is required to be installed on the Linux VPS, so install it using the following command:

yum install java-1.7.0-openjdk

Download the latest version of eXo Platform available at http://sourceforge.net/projects/exo/files

cd /root/
wget http://sourceforge.net/projects/exo/files/latest/download -O eXo-Platform-community.zip
unzip eXo-Platform-community.zip
mv platform-community-* platform-community

Move the ‘/root/platform-community’ directory to the ‘/usr/share/platform-community’ directory:

mv /root/platform-community /usr/share/platform-community

To start the eXo Platform, use the following command (use the ‘–background’ option to start the eXo Platform as a background process)


To stop the eXo Platform, use the following command


You can access eXo platform at http://your-domain.com:8080/

Or, configure Apache as a reverse proxy so it can handle and pass the requests to eXo Platform and hide the port number in the URL.

Edit the ‘/etc/httpd/conf/httpd.conf’ Apache configuration file and uncomment the following line:

#NameVirtualHost *:80

Then, add the following virtual host at the end:

<VirtualHost *:80>
ServerName your-domain.com
ServerAlias www.your-domain.com

ProxyRequests Off
<Proxy *>
Order deny,allow
Allow from all

ProxyPass / http://your-domain.com:8080/
ProxyPassReverse / http://your-domain.com:8080/
<Location />
Order allow,deny
Allow from all

Make sure the mod_proxy module is enabled and restart the Apache service for the changes to take effect using the following command:

service httpd restart

The eXo Platform can now be accessed by opening http://your-domain.com/ . Make sure you create a primary user account:

That is it. You can start using the eXO social collaboration platform and explore its great features such as document management, portal, calendar, forums, answers, dashboards, wiki, spaces, user profiles, tasks, connections, polls, posts, activity streams and more.

Of course you don’t have to do any of this if you use one of our Linux VPS Hosting services, in which case you can simply ask our expert Linux admins to install eXo platform for you. They are available 24×7 and will take care of your request immediately.

PS. If you liked this post please share it with your friends on the social networks using the buttons on the left or simply leave a reply below. Thanks.

View Comments

  • If I stop and start eXo using /usr/share/platform-community/start_eXo.sh I seem to lose all login and memer data. Is that normal? Thanks