Learn how to – How To Install EGroupware on Ubuntu 20.04|18.04 & Debian 10

Learn how to – How To Install EGroupware on Ubuntu 20.04|18.04 & Debian 10.

EGroupware is a an open source collaboration, groupware software based on PHP, JS and HTML and distributed under the terms of GNU General Public License (GPL) Version 2. You can use EGroupware via its native web-interface, allowing platform-independent access, or by using different supported clients using CalDAV/CardDAV or ActiveSync protocol. In this guide, we will walk you through the installation of EGroupware CE on Ubuntu 20.04|18.04 & Debian 10 Linux machine.

Features of EGroupware

• File Manager – Provides a detailed rights administration, archiving options and reading access to files for external partners make it easy.
• Calendar – Schedule meetings, vacations and group appointments online.
• Web Admin – Lots of needful tools and preferences to maintain the whole platform
• Email Client – The integrated E-Mail Client is perfectly connected with the other modules like Calendar or InfoLog.
• Tasks and Projects – Manage information and responsibilities for your whole team efficiently.

Now that you’re ready for installation, follow the steps outlined in the next section to install EGroupware CE on Ubuntu 20.04|18.04:

Step 1: Update Ubuntu System

Update the system packages to the latest available versions.

sudo apt update
sudo apt -y upgrade && sudo systemctl reboot

Step 2: Add EGroupware APT Repository

We will be doing installation of EGroupware CE which is based on Docker containers. We need to add the repository which provides the packages needed for running EGroupware on Ubuntu.

Install gnupg package:

sudo apt update
sudo apt -y install gnupg

Ubuntu 20.04:

wget -nv https://download.opensuse.org/repositories/server:eGroupWare/xUbuntu_20.04/Release.key -O - | sudo apt-key add -
echo 'deb http://download.opensuse.org/repositories/server:/eGroupWare/xUbuntu_20.04/ /' | sudo tee /etc/apt/sources.list.d/server:eGroupWare.list

Ubuntu 18.04:

wget -nv https://download.opensuse.org/repositories/server:eGroupWare/xUbuntu_18.04/Release.key -O - | sudo apt-key add -
echo 'deb http://download.opensuse.org/repositories/server:/eGroupWare/xUbuntu_18.04/ /' | sudo tee /etc/apt/sources.list.d/server:eGroupWare.list

Debian 10:

wget -nv https://download.opensuse.org/repositories/server:eGroupWare/Debian_10/Release.key -O - | sudo apt-key add -
echo 'deb http://download.opensuse.org/repositories/server:/eGroupWare/Debian_10/ /' | sudo tee /etc/apt/sources.list.d/server:eGroupWare.list

Step 3: Install EGroupware on Ubuntu 20.04|18.04 & Debian 10

Start the installation of EGroupware packages:

sudo apt update
sudo apt install egroupware-docker egroupware-collabora-key egroupware-rocketchat

You can review dependencies and accept installation:

Reading package lists... Done
Building dependency tree
Reading state information... Done
The following additional packages will be installed:
  apache2 apache2-bin apache2-data apache2-utils bridge-utils containerd dns-root-data dnsmasq-base docker-compose docker.io jq libapr1 libaprutil1
  libaprutil1-dbd-sqlite3 libaprutil1-ldap libidn11 libjansson4 libjq1 liblua5.2-0 libonig5 net-tools pigz python3-cached-property python3-docker
  python3-dockerpty python3-docopt python3-texttable python3-websocket runc ssl-cert ubuntu-fan
Suggested packages:
  apache2-doc apache2-suexec-pristine | apache2-suexec-custom www-browser ifupdown aufs-tools cgroupfs-mount | cgroup-lite debootstrap docker-doc rinse zfs-fuse
  | zfsutils mariadb-server | mysql-server egroupware-epl-jdots egroupware-epl-phpbrain egroupware-epl-sitemgr egroupware-epl-wiki openssl-blacklist
The following NEW packages will be installed:
  apache2 apache2-bin apache2-data apache2-utils bridge-utils containerd dns-root-data dnsmasq-base docker-compose docker.io egroupware-collabora-key
  egroupware-docker egroupware-rocketchat jq libapr1 libaprutil1 libaprutil1-dbd-sqlite3 libaprutil1-ldap libidn11 libjansson4 libjq1 liblua5.2-0 libonig5
  net-tools pigz python3-cached-property python3-docker python3-dockerpty python3-docopt python3-texttable python3-websocket runc ssl-cert ubuntu-fan
0 upgraded, 34 newly installed, 0 to remove and 131 not upgraded.
Need to get 72.1 MB of archives.
After this operation, 352 MB of additional disk space will be used.
Do you want to continue? [Y/n] y

Ensure docker and mariadb services are set to start at boot.

sudo systemctl enable --now mariadb docker

Confirm status of Docker containers.

$ sudo docker ps
CONTAINER ID   IMAGE                                     COMMAND                  CREATED              STATUS              PORTS                      NAMES
91120ca8959f   quay.io/egroupware/collabora-key:stable   "/bin/sh -c 'bash st…"   52 seconds ago       Up 51 seconds       127.0.0.1:9980->9980/tcp   collabora-key
92a901e5fa4f   nginx:stable-alpine                       "/docker-entrypoint.…"   About a minute ago   Up About a minute   127.0.0.1:8080->80/tcp     egroupware-nginx
b385fdc3f11a   phpswoole/swoole:4.6-php7.4-alpine        "docker-php-entrypoi…"   About a minute ago   Up About a minute                              egroupware-push
011d62ae8bdd   containrrr/watchtower:latest              "/watchtower --sched…"   About a minute ago   Up About a minute   8080/tcp                   egroupware-watchtower
c8895817c655   egroupware/egroupware:20.1                "/entrypoint.sh php-…"   About a minute ago   Up About a minute   9000/tcp                   egroupware
962aef34f4e8   mariadb:10.4                              "docker-entrypoint.s…"   About a minute ago   Up About a minute   3306/tcp                   egroupware-db
84c797032ad3   quay.io/egroupware/rocket.chat:stable     "docker-entrypoint.s…"   2 minutes ago        Up 2 minutes        127.0.0.1:3000->3000/tcp   rocketchat
7f17129ecd28   mongo:4.0                                 "docker-entrypoint.s…"   2 minutes ago        Up 2 minutes        27017/tcp                  rocketchat-mongo

Step 4: Accessing EGroupware CE Dashboard

Obtain Login credentials after installation of EGroupware on Ubuntu 20.04|18.04 LTS.

$ cat /var/lib/egroupware/egroupware-docker-install.log 
Fix APC(u) configuration, set apc.shm_size=128M in /etc/php/7.3/cli/conf.d/20-apcu.ini
Timezones updated to version 2.2019c (546 records updated).
Timezones aliases updated to version 2020-04-09 09:54:19 (87 records updated).
You might need to clear the cache for changes to be visiable: Admin >> Clear cache!

EGroupware successful installed
===============================

Please note the following user names and passwords:

Setup username:      admin
      password:      pTs3c!xSoZwQs@S5

EGroupware username: sysop
           password: uka(x3j2OO|?=2gZ

You can log into EGroupware by pointing your browser to http://localhost/egroupware/
Please replace localhost with the appropriate hostname, if you connect remote.

*** Database has no root password set, please fix that immediatly: mysqladmin -u root password NEWPASSWORD

Go to http://example.org/egroupware page to login to the dashboard with credentials:

Use the credentials shown in the Docker compose run output to login.

You can start administering EGroupware and configuring third party integrations.

For CentOS refer to:

Install EGroupware CE on CentOS 7 / CentOS 8