Skip to content

20.1 Installation using egroupware docker RPM DEB package

Ralf Becker edited this page Jul 31, 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
  • mail servers can be configured to notify EGroupware about new mails

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

We have now also a 20.1 Univention App available in their TestAppCenter, which need to be enabled before you get the 20.1 versions offered for updating as usual.

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