CentOS RedHat Installation

Wiki ▸ Installation ▸ EGroupware CentOS/RedHat Installation

CentOS/RedHat Installation

This installation instruction is based on CentOS 7. If you wish to install EGroupware on other environments please select relevant instruction from the below list.

Debian

openSUSE/SLEs

Ubuntu

For any Linux distribution the installation steps has to be done as user root and with root rights in a terminal session.

---

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/yum.repos.d/egroupware-epl.repo Add the following lines: #EGroupware EPL repository [egroupware-epl] name=EGroupware EPL (RHEL_7 VERSION) type=rpm-md baseurl= https://USERNAME:PASSWORD@download.egroupware.org/repos/stylite-epl/RHEL_7/ gpgkey= https://USERNAME:PASSWORD@download.egroupware.org/repos/stylite-epl/RHEL_7/repodata/repomd.xml.key gpgcheck=1 enabled=1 autorefresh=1
2- Install PHP 7

yum install -y https://centos7.iuscommunity.org/ius-release.rpm
yum install -y mod_php72u php72u-{common,gd,mysqlnd,pdo,tidy,opcache,pecl-apcu}

| 3-
yum install mariadb-server
systemctl start mariadb
yum 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

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/yum.repos.d/egroupware-epl.repo

For EPL Version:

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

Example:

#EGroupware EPL repository
deb https://peter:secret@download.egroupware.org/repos/stylite-epl/RHEL_7/ ./

OR

For Community Version:

cd /etc/yum.repos.d/
wget https://download.opensuse.org/repositories/server:eGroupWare/DISTRO_NAME/server:eGroupWare.repo

Example:

cd /etc/yum.repos.d
wget https://download.opensuse.org/repositories/server:eGroupWare/CentOS_7/server:eGroupWare.repo

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

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

DISTRO_NAME
CentOS_7	CentOS_6
RHEL_7	RHEL_6

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

cat /etc/os-release

Step 2:

Unfortunately RHEL/CentOS 7 come with the ancient PHP version 5.4, so we need to install a recent PHP version.

yum install -y https://centos7.iuscommunity.org/ius-release.rpm
yum install -y mod_php72u php72u-{common,gd,mysqlnd,pdo,tidy,opcache,pecl-apcu}

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.

yum install mariadb-server
systemctl start mariadb
yum install egroupware-epl

e.g. for nginx installation:

yum install mariadb-server
systemctl start mariadb
yum install epel-release
yum install nginx
yum systemctl start nginx
yum install egroupware-epl

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.

Firewall and SELinux:
CentOS-7 has its firewall by default on and it might restrict you to reaching your webserver. It's recommended to configure your firewall properly to allow access.
Another restriction access might be from SELinux which is switched on by default and you need to see it properly for your environment. To switch both off, run the following:

systemctl disable firewalld
sed -i 's/SELINUX=.*/SELINUX=permissive/g' /etc/sysconfig/selinux
reboot

IMPORTANT: Switching off above mentioned security features could cause major security risks, please configure them properly.

Step 5:

Congratulations!!!

_back to Top

---

End of Document

---