How to install eGroupware on an Ubuntu 14.04 VPS

In the following article we are going to cover the installation steps for eGroupware on an Ubuntu 14.04 Virtual Server.

What is eGroupware?

It is free and open source groupware software intended for businesses from small to enterprises. Its primary functions allow users to manage contacts, appointments, projects and to-do lists.


eGroupware runs on an Ubuntu base system, requires a webserver, a database server, a mail server etc.


OK, before proceeding any further, make sure you’re in a screen session and your Ubuntu 14.04 Linux VPS is fully up-to-date using:

## screen -U -S egroupware
## apt-get update
## apt-get upgrade

Since eGroupware requires a webserver, a database server and a PHP server/support, we will have to install and set-up LAMP (Linux Apache MySQL and PHP) on the system.

First, lets install Apache2 on your Ubuntu 14.04 VPS using:

## apt-get install apache2

Next, proceed with installing the MySQL database server in your system using

## apt-get install mysql-server

once installed, run the post-installation script mysql_secure_installation and configure it like this

## mysql_secure_installation

- Set root password? [Y/n] y
- Remove anonymous users? [Y/n] y
- Disallow root login remotely? [Y/n] y
- Remove test database and access to it? [Y/n] y
- Reload privilege tables now? [Y/n] y

Ok, finally install PHP support on the system using the command below. This will also install eGroupware dependencies.

## apt-get install php-pear tnef php5 php5-{gd,imap,mysql,ldap}

Enable PHP-IMAP extension by executing the following commands:

## php5enmod imap
## service apache2 restart

Install jpgraph which is another eGroupware dependency.

## wget "http://jpgraph.net/download/download.php?p=5" -O /tmp/jpgraph.tar.gz
## tar zxf /tmp/jpgraph.tar.gz -C /var/www/html
## mv /var/www/html/jpgraph* /var/www/html/jpgraph

Next thing to do is to actually install eGroupware on your Ubuntu Linux Virtual Server. Go at http://sourceforge.net/projects/egroupware/files/ and download the latest version of eGroupware (egroupware-epl and egroupware-epl-egw-pear). At the time of writing this article, the version is 14.1 so

## cd /var/www/html
## wget http://downloads.sourceforge.net/project/egroupware/eGroupware-14.1/eGroupware-14.1.20140710/egroupware-epl-14.1.20140710.tar.gz
## wget http://downloads.sourceforge.net/project/egroupware/eGroupware-14.1/eGroupware-14.1.20140710/egroupware-epl-egw-pear-14.1.20140710.tar.gz

once the tar archives are downloaded to /var/www/html, let’s extract them using:

## tar zxf egroupware-epl-14.1.*.tar.gz
## tar zxf egroupware-epl-egw-pear-14.1.*.tar.gz

remove downloaded archives if you don’t need them:

## rm -f /var/www/html/egroupware-epl-*.tar.gz

set-up ownership to /var/www/html/egroupware:

## chown www-data: -R /var/www/html/egroupware

with all that in place, it is time to set-up some PHP parameters, like upload_max_filesize, date.timezone, mbstring.func_overload etc.

You can change these in your php.ini using your favorite text editor or you can use the following sed commands:

## upload max filesize
sed -E -i "s/(upload_max_filesize.*=)(.*)/\1 8M/" /etc/php5/apache2/php.ini

## set-up time zone
sed -E -i "s/(^.*date.timezone.*=)/date.timezone = America\/New_York/" /etc/php5/apache2/php.ini

## set-up Mbstring func_overload
sed -E -i "s/^.*mbstring.func_overload.*/mbstring.func_overload = 0/" /etc/php5/apache2/php.ini

You will also need a database for your eGroupware, so create one using your favorite MySQL web-manager or use command line as in:

## mysql -u root -p
mysql> create database egroupware;
mysql> grant all on egroupware.* to egroupware@localhost identified by 'egroupware';
mysql> \q

Next, restart Apache2 for the changes to take effect using:

## service apache2 restart

and point your browser to http://YOUR_SERVER_[IP-HOSTNAME]/egroupware . You should get something like this:

click the ‘Run installation tests’ hyper link

make sure you fix any errors shown on this page. Once everything is OK, proceed to the next step by clicking the ‘Continue to the Header Admin’ hyperlink. You should see something like the picture below:

click the ‘View’ link and copy and paste the header.inc.php file to egroupware/header.inc.php

## vim egroupware/header.inc.php

once the header.inc.php is in place, click ‘Continue’ to finish the installation.

Of course you don’t have to do any of this if you use one of our Linux VPS Hosting services, in which case you can simply ask our expert Linux admins to install eGroupware for you. They are available 24×7 and will take care of your request immediately.

PS. If you liked this post please share it with your friends on the social networks using the buttons on the left or simply leave a reply below. Thanks.


Categories: Tutorials

View Comments

Leave a Comment