eXo Platform Enterprise Edition - 30 Days Free trial

Try our Entreprise Edition, with entreprise feature such as :  Entreprise theme  Chat  Tasks  Document editing  Web pack Templates   Consider Entreprise Edition if you are interested in :  Professional global support  Wide range of certified IT envirements  Timely bugfixes and free updates Are you an existing customer ? Download entreprise edition from your customer space. Look what some of our clients did with eXo Platform Enterprise Edition       Try eXo Platform EELatest milestone

eXo Platform Community Edition

Lightweight open source collaborative platform core  Enjoy commnunity-led support  Pay nothing. It's free   Get eXo Platform CELatest milestone

Connect and collaborate with eXo Mobile apps

Follow the latest updates from your colleagues and groups, interact with your personal dashboards, browse and edit your files, and more – at any time, from anywhere. Native iPhone, iPad, and Android apps integrate easily and securely with your eXo instance, on-premise or in the cloud.

Enhance your eXo Platform installation

Install new apps, connectors, new features, skins and templates in the eXo add-ons center.    Find Add-ons for eXo

Teach yourself how to make the best of your eXo Platform

Comprehensive documentation provides admins, developers and end users with all the information they need to develop and deploy successul projects with eXo Platform. Downloadable PDF versions of all docs are available to eXo Tribe members.  Latest Version 5.0  Developer's Guide Administrator's Guide Reference Guide User's Guide Mobile Guide Add-ons Guide

eXo Platform Community Docker image

The eXo Platform Community edition Docker image support HSQLDB (for testing) and MySQL (for production).

• Quick start
• Configuration options
  • Add-ons
  • JVM
  • Frontend proxy
  • Tomcat
    • Data on disk
  • Database
    • MySQL
  • Mongodb
  • ElasticSearch
  • Mail
  • JMX
• How-to
  • configure eXo Platform behind a reverse-proxy
  • use MySQL database
  • see eXo Platform logs
  • install eXo Platform add-ons
  • list eXo Platform add-ons available
  • list eXo Platform add-ons installed
  • customize some eXo Platform settings
• Image build

Quick start

The prerequisites are :

• Docker daemon version 12+ + internet access
• 4GB of available RAM + 1GB of disk

The most basic way to start eXo Platform Community edition for evaluation purpose is to execute

docker run -v exo_data:/srv/exo -p 8080:8080 exoplatform/exo-community

and then waiting the log line which say that the server is started

2017-05-22 10:49:30,176 | INFO  | Server startup in 83613 ms [org.apache.catalina.startup.Catalina<main>]

When ready just go to http://localhost:8080 and follow the instructions ;-)

Configuration options

Add-ons

Some add-ons are already installed in eXo image but you can install other one or remove some of the pre-installed one :

JVM

The standard eXo Platform environment variables can be used :

INFO: This list is not exhaustive (see eXo Platform documentation or {EXO_HOME}/bin/setenv.sh for more parameters)

Frontend proxy

The following environment variables must be passed to the container to configure Tomcat proxy settings:

Tomcat

The following environment variables can be passed to the container to configure Tomcat settings

Data on disk

The following environment variables must be passed to the container in order to work :

Database

The following environment variables must be passed to the container in order to work :

MySQL

Mongodb

The following environment variables should be passed to the container in order to work if you installed eXo Chat add-on :

INFO: you must configure and start an external MongoDB server by yourself

ElasticSearch

The following environment variables should be passed to the container in order to configure the search feature on an external Elastic Search server:

INFO: the default embedded ElasticSearch in not recommended for production purpose.

Mail

The following environment variables should be passed to the container in order to configure the mail server configuration to use :

JMX

The following environment variables should be passed to the container in order to configure JMX :

With the default parameters you can connect to JMX with service:jmx:rmi://localhost:10002/jndi/rmi://localhost:10001/jmxrmi without authentication.

How-to

configure eXo Platform behind a reverse-proxy

You have to specify the following environment variables to configure eXo Platform (see upper section for more parameters and details) :

docker run -d \
  -p 8080:8080 \
  -e EXO_PROXY_VHOST="my.public-facing-hostname.org" \
  exoplatform/exo-community

You can also use Docker Compose (see the provided docker-compose.yml file as an example).

use MySQL database

You have to specify the following environment variables to point to an external MySQL database server (see upper section for more parameters and details) :

docker run -d \
  -p 8080:8080 \
  -e EXO_DB_TYPE="mysql" \
  -e EXO_DB_HOST="mysql.server-hostname.org" \
  -e EXO_DB_USER="exo" \
  -e EXO_DB_PASSWORD="my-secret-pw" \
  exoplatform/exo-community

You can also use Docker Compose (see the provided docker-compose.yml file as an example).

see eXo Platform logs

docker logs --follow <CONTAINER_NAME>

install eXo Platform add-ons

To install add-ons in the container, provide a commas separated list of add-ons you want to install in a EXO_ADDONS_LISTenvironment variable to the container:

docker run -d \
  -p 8080:8080 \
  -e EXO_ADDONS_LIST="exo-tasks:1.3.x-SNAPSHOT,exo-answers:1.3.x-SNAPSHOT" \
  exoplatform/exo-community

INFO: the provided add-ons list will be installed in the container during the container creation.

list eXo Platform add-ons available

In a running container execute the following command:

docker exec <CONTAINER_NAME> /opt/exo/addon list

list eXo Platform add-ons installed

In a running container execute the following command:

docker exec <CONTAINER_NAME> /opt/exo/addon list --installed

customize some eXo Platform settings

As explained in eXo Platform documentation you can customize several aspects of eXo platform by settings environment variables :

docker run -d \
  -p 8080:8080 \
  -e EXO_JVM_SIZE_MAX="8g" \
  exoplatform/exo-community

Image build

The simplest way to build this image is to use default values :

docker build -t exoplatform/exo-community .

This will produce an image with the current eXo Platform Community edition.

The build can be customized with the following arguments :