Important deprecation note

Package installation of the OpenPaaS platform is currently deprecated. The current page is kept for informational purpose, but note that it will install the version 1.3 (Oct. 18) of the platform.

---

Table of contents

• Important deprecation note
• Setup the target machine
  • Hostname
  • Bootstrap the installation
• Install packages
  • On Debian Jessie
  • On Debian Stretch
  • On RHEL or CentOS
• Initialize OpenPaaS
• Enjoy
• Discover
  • Global presentation (EN)
  • Unified Inbox introduction (FR)
  • Calendar introduction (FR)

Installing OpenPaaS on a Linux server is very easy using provided system packages. This installation method is currently only supported on Debian Jessie and RHEL 7 (or its community companion CentOS 7).

Make sure you are starting from a minimal installation for both distributions. The machine should only have standard system utilities (and ssh service).

If you just want to try OpenPaaS, check out the Docker guide

Setup the target machine

Hostname

Set the target machine’s hostname using the following command:

hostnamectl set-hostname openpaas.local

Make sure the hostname is correctly resolved locally using this command:

echo "127.0.0.1 openpaas.local openpaas james.openpaas.local dav.openpaas.local" | tee -a /etc/hosts

Bootstrap the installation

We provide a small bootstrap script to quickly setup the required repositories on the machine you will install OpenPaaS on. To use it, simply run, as root:

wget -qO - https://raw.githubusercontent.com/linagora/openpaas-esn/master/packaging/setup-v1.2.sh | bash

or

curl -s https://raw.githubusercontent.com/linagora/openpaas-esn/master/packaging/setup-v1.2.sh | bash

depending on the availability of either wget or curl on your system.

Install packages

Once the bootstrap script has run, you can install the required packages.

On Debian Jessie

As root:

• Remove exim

  apt-get remove -y ^exim*
  

  Removing the default mail transfer agent (exim) is required because OpenPaaS comes with a full-featured mail server that also serves as a MTA.

• Install openjdk-8

  apt-get install -t jessie-backports -y openjdk-8-jdk
  update-alternatives --set java /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java
  

• Install OpenPaaS packages

  apt-get install -y openpaas openpaas-davserver openpaas-james
  

• Enable mongodb service, not enable by default on Jessie :

  systemctl enable mongod
  systemctl start mongod
  

To make sure all services are started and enabled on boot, run the following commands as root:

systemctl status {mongod,elasticsearch,cassandra,redis-server,rabbitmq-server,nginx,james,openpaas}

On Debian Stretch

As root:

• Install OpenPaaS packages

  apt-get install -y openpaas openpaas-davserver openpaas-james
  

To make sure all services are started and enabled on boot, run the following commands as root:

systemctl status {mongodb,elasticsearch,cassandra,redis-server,rabbitmq-server,nginx,james,openpaas}

On RHEL or CentOS

As root, run:

yum erase -y postfix
yum install -y openpaas openpaas-davserver openpaas-james

Removing the default mail transfer agent (postfix) is required because OpenPaaS comes with a full-featured mail server that also serves as a MTA.

To make sure all services are started and enabled on boot, run the following commands as root:

systemctl enable {mongod,elasticsearch,cassandra,redis,rabbitmq-server,php-fpm,nginx,james,openpaas}
systemctl start {mongod,elasticsearch,cassandra,redis,rabbitmq-server,php-fpm,nginx,james,openpaas}

You will also need to configure the firewall to access the different needed ports. For a simple test you can deactivate it:

systemctl stop firewalld

Initialize OpenPaaS

To create a domain and your first administrator, run the following command as the openpaas user or as root:

opctl init --email admin@openpaas.local

User is created by default as Domain admin. If needed, set your user as Platform Admin (see Platform mode) with the following command:

opctl platformadmin init --email admin@openpaas.local

The command also provision configurations, hence you need to restart OpenPaaS and James to make these services work properly with the new configurations:

systemctl restart {james,openpaas}

Enjoy

OpenPaaS is installed using the openpaas.local hostname by default, meaning you must access it using this hostname. To do this, add the following line to your /etc/hosts file (unless you can make openpaas.local resolve to the machine’s IP address using a DNS server):

x.x.x.x openpaas.local davserver.openpaas.local james.openpaas.local

You can then open a compatible browser to http://openpaas.local and login using admin@openpaas.local with password admin.

Discover

Some videos to help discover the product:

Global presentation (EN)

Unified Inbox introduction (FR)

Calendar introduction (FR)