Installation

Wiki ▸ Installation ▸ EGroupware Installation

Installation

This installation instruction is based on Ubuntu 16.04 (highly recommended), if you wish to install EGroupware on other environments please select relevant instruction from the below list.

Centos/RedHat	openSUSE/SLEs	Debian

Ubuntu

IMPORTANT: EGroupware installation consists of two versions; EPL Version and Community Version. Technically, the only installation difference between EPL and Community version is their repository URLs. Please make sure you will follow relevant difference parts of your desired version.

Are you an expert admin? then follow the Express Instruction below, otherwise please follow step-by-step installation.

Express Instruction
1- `vi /etc/apt/source.list.d/egroupware-epl.sources.list` Add the following lines: `#EGroupware EPL repository` `deb http://USERNAME:PASSWORD@download.egroupware.org/repos/stylite-epl/xUbuntu_16.04/ ./`
2- `apt update` See step 2 to add repository key
3- `apt install egroupware-epl` follow the installation instruction
4- `less /root/egroupware-epl.log`
5- Congratulations!!! You may login to your EGroupware instance

STEP-BY-STEP INSTALLATION

Whether you're on Ubuntu or Debian you can quickly install EGroupware by following below steps:

step 1:

Add EGroupware repository into source lists in order to fetch EGroupware's packages.

 vi /etc/apt/source.list.d/egroupware-epl.sources.list

For EPL Version:

#EGroupware EPL repository
deb http://USERNAME:PASSWORD@download.egroupware.org/repos/stylite-epl/DISTRO_NAME/ ./

Example:

#EGroupware EPL repository
deb http://peter:secret@download.egroupware.org/repos/stylite-epl/xUbuntu_16.04/ ./

OR

For Community Version:

#EGroupware Community repository
deb http://download.egroupware.org/repositories/server:/eGroupWare/DISTRO_NAME/ ./

Example:

#EGroupware Community repository
deb  http://download.opensuse.org/repositories/server:/eGroupWare/xUbuntu_16.04/ ./

Replace the following variables used in above urls with your own values: USERNAME:PASSWORD are your given credentials for EPL version.

DISTRO_VERSION: Means the version of distribution you're install EGroupware on it. You can find out the right version name from following list:

DISTRO_VERSION
xUbuntu_17.10	xUbuntu_16.04	xUbuntu_14.04	xUbuntu_12.04	xUbuntu_10.04

*** if you are not sure what distribution you're running, simply execute the following command:

cat /etc/os-release

Step 2:

After adding EGroupware's repository into sources list, we need to update to fetch packages. Before doing the update we are going to make sure that we have the repository key added.

EGroupware EPL Version:

wget -O - http://USER:PASSWORD@download.egroupware.org/build%40egroupware.org | apt-key add -

OR

EGroupware Community Version:

wget -nv https://download.opensuse.org/repositories/server:eGroupWare/xUbuntu_16.04/Release.key -O Release.key | apt-key add -

if you're not running xUbuntu_16 please see DISTRO_VERSION to find out your distro specific url.

apt update

Step 3:

Now it's time to install egroupware-epl packages. Depends on the webserver you would like to use with EGroupware, you may install a webserver among the egroupware-epl packages, by default Apache will be installed.

apt install egroupware-epl

e.g. for nginx installation:

apt install nginx egroupware-epl

follow the installation instruction as shown in following figures:

In the following instructions whenever you leave a password field empty, a randomized password gets generated which you can get access to it via egroupware-epl.log file after installation is completed.

Step 4:

You may check egroupware-epl.log file in order to check if everything went well during the installation plus you can get access to your egroupware credentials.

less /root/egroupware-epl.log

from this moment on you may get logged in to your EGroupware instance via the mentioned url in egroupware-epl.log. Although, before doing that we highly do recommend to take couple of more steps to adjust couple of settings for PHP and MyQL in order to get the best performance.