Skip to content

20.1 Installation using egroupware docker RPM DEB package

Ralf Becker edited this page Jul 14, 2020 · 12 revisions

20.1 is still in a release candidate state, so make proper backup, before updating any essential installations

Major differences from a 19.1 installation

  • push server in an additional egroupware-push container, allowing instant updates without polling
  • new installations use MariaDB 10.4 in an additional egroupware-db container (19.1 updates keep using the database on the host)
  • new installations use Nginx as webserver/proxy on the host by default, unless you specify explicitly to use Apache2
  • modifications to docker-compose file are now kept in a separate docker-compose.override.yml to ease updates
  • Rocket.Chat is no longer automatic installed, as you should install your https certificate before!
  • EGroupware now uses TypeScript instead of plain JavaScript to ease client-side development

20.1 packages are currently available only in a special repository

The following example is for Ubuntu 20.04 (replace 20.04 with 18.04 or 16.04, or xUbuntu_20.04 with Debian_10):

For CentOS, RHEL, openSUSE or SLES follow the 19.1 instructions replacing server:/eGroupWare with server:/eGroupWare:/trunk in the repository

sudo sh -c "echo 'deb http://download.opensuse.org/repositories/server:/eGroupWare:/trunk/xUbuntu_20.04/ /' > /etc/apt/sources.list.d/server:eGroupWare:trunk.list"

sudo apt-get install gnupg # required for Debian 10 to use apt-key add

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

apt update

To upgrade in place from 19.1

apt upgrade

Use the default to NOT replace config-files, if you are asked. The update script takes care of all necessary changes!

For a new 20.1 installation

apt install egroupware-docker

If you prefer to use Apache2 on the host as proxy, add apache2 to the above install command.

It will create (or update) the following files in /etc/egroupware-docker:

  • nginx.conf config for using Nginx as proxy on the host, symlinked to /etc/nginx/conf.d/egroupware.conf
  • apache.conf config for using Apache2 on the host, symlinked to /etc/apache2/sites-{enabled,avalable}/egroupware.conf
  • docker-compose.override.yml for local modifications with many commented out examples (contains your 19.1 docker-compose.yml in case of an update!)
  • .env contains root password of MariaDB container
  • mariadb.cnf file to overfide MariaDB configuration in the container
  • docker-compose.yml, latest-*.yml or create-override.sh do NOT modify!
  • use-epl.sh script to update to EPL (EGroupware GmbH subscription version)
  • egroupware-logs.sh tail EGroupware's error-log

This currently brief information will receive more updates in the next weeks. In the meantime most of the 19.1 documentation is valid for 20.1 too.

Clone this wiki locally