OpenPaaS Documentation logo OpenPaaS Documentation

Table of contents

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 - get.open-paas.org | bash

or

curl -s get.open-paas.org | 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:

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

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

On Debian Stretch

As root:

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

systemctl enable {mongodb,elasticsearch,cassandra,redis-server,rabbitmq-server,nginx,james,openpaas}
systemctl start {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 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)