diff --git a/19.1--Installtion-using-egroupware-docker-RPM-DEB-package.md b/19.1--Installtion-using-egroupware-docker-RPM-DEB-package.md new file mode 100644 index 0000000..9602dcd --- /dev/null +++ b/19.1--Installtion-using-egroupware-docker-RPM-DEB-package.md @@ -0,0 +1,82 @@ +The 19.1+ installation is based on **Docker**, even for the DEB or RPM packages. +The only requirement for the host system is Docker and for DEB/RPM packages a recent MariaDB or MySQL. + +> There is no difference in most parts of the installation between **community edition** (CE) and EGroupware GmbH **EPL** version. Same is true for an in-place upgrade from 17.1 and a new installation. + +*19.1 is currently in release-candidate phase, and therefore in a different package repository then the old stable version 17.1. This will change, once 19.1 is officially released.* + +You first need to create a repository file for your Linux distribution and version and import the key for it. +I'll show it here in details for Ubuntu 18.04, for other distributions use [this link](https://software.opensuse.org/download/package.iframe?project=server%3AeGroupWare%3Atrunk&package=egroupware-docker). + +Run the following commands as root on Ubuntu 18.04 to install or update EGroupware: +``` +sudo sh -c "echo 'deb http://download.opensuse.org/repositories/server:/eGroupWare:/trunk/xUbuntu_18.04/ /' > /etc/apt/sources.list.d/server:eGroupWare:trunk.list" +wget -nv https://download.opensuse.org/repositories/server:eGroupWare:trunk/xUbuntu_18.04/Release.key -O - | +sudo apt-key add - +sudo apt-get update +sudo apt-get install egroupware-docker +``` +This will use Apache as webserver on the host for new installation and whatever was already used for updates. +If you prefer to use Nginx for new installations, just add "nginx" before egroupware-docker in the above command. + +If this is a new installation and you missed the credentials of your first EGroupware admin user "sysop" or the EGroupware setup user "admin", you can always find them under /var/lib/egroupware/egroupware-docker-install.log. +## How to install EGroupware GmbH's EPL version +The update described above will remove the EPL packages, of cause leaving your data intact. +To install the EPL source / run the EPL container you need your download.egroupware.org credentials and run the following commands: +``` +docker login download.egroupware.org +User: +Password: +cd /etc/egroupware-docker +sed -i 's#egroupware/egroupware#download.egroupware.org/egroupware/epl#g' docker-composer.yml +docker-compose up -d +``` +## Some more technical information what the installation is actually doing ## +* the package will install docker, docker-compose and MariaDB-server, if not already installed +* it will install a docker-compose file and some Apache and Nginx config files in /etc/egroupware-docker: +1. **docker-compose.yml** starts the docker containers +1. **egroupware-nginx.conf** is the configuration of the internal Nginx container +1. **apache.conf** or **nginx.conf** are the configuration for the webserver on the host +* EGroupware files will be store (as usual) in /var/lib/egroupware on the host +* it will start the following container: +1. **egroupware** Ubuntu 18.04 based container with PHP 7.3 FPM and the EGroupware sources +1. **egroupware-nginx** Alpine based container with internal Nginx server +1. **egroupware-watchtower** automatic updating all containers to new version, if available, at 4am daily +## How to install third party or deprecated apps +The following apps, which are deprecated since 14.3, are no longer part of 19.1: +1. egroupware-epl-wiki +1. egroupware-epl-sitemgr +1. egroupware-epl-phpbrain +1. egroupware-epl-compat + +They can however be installed from 17.1 repo or are kept in case of an update. + +They will work with the 19.1 container, as docker-compose.yml passes /usr/share/egroupware from the host into the container as /usr/share/egroupware-extra. The container [entrypoint script](https://github.com/EGroupware/docker/blob/master/fpm/entrypoint.sh#L8) copies them into the volume shared between egroupware container and Nginx. + +This mechanism can also be used to add arbitrary third-party apps to an EGroupware running in a container: +``` +mkdir -p /usr/share/egroupware +git clone +docker restart egroupware +``` +## How to view error-log of the webserver +In case of an error you can look at the error log with the following command: +``` +docker logs -f egroupware +``` +## How to install Collabora Online Office +After EGroupware 19.1 is installed and working, you can add Collabora by installing our **egroupware-collabora-key** package from the stable / 17.1 repo (server:eGroupWare instead of server:eGroupWare:trunk). + +If you prefer to use / test with [CODE Collabora Online Development Edition](https://www.collaboraoffice.com/code/) you can change the container image in from "quay.io/egroupware/collabora-key" to "collabora/code": +``` +cd /etc/egroupware-collabora-key +sed -i 's#quay.io/egroupware/collabora-key#collabora/code#g' docker-compose.yml +docker-compose up -d +docker cp /var/lib/egroupware/default/loolwsd/loolwsd.conf egroupware-collabora-key:/etc/loolwsd +docker-compose restart +``` +(Please note that CODE is limited in the number of concurrent users, while our image supports the licensed number of users.) +## How to install Rocket.Chat +After EGroupware 19.1 is installed and working, you can add Rocket.Chat by installing our **egroupware-rocketchat** package. + +In contrary to our hosting or trials, Rocket.Chat in an on premise installation requires several configuration steps in EGroupware and Rocket.Chat, see the separate chapter in this wiki.