diff --git a/20.1--Installation-using-egroupware-docker-RPM-DEB-package.md b/20.1--Installation-using-egroupware-docker-RPM-DEB-package.md new file mode 100644 index 0000000..a7d4d04 --- /dev/null +++ b/20.1--Installation-using-egroupware-docker-RPM-DEB-package.md @@ -0,0 +1,49 @@ +> 20.1 is still in a beta 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 +* 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](https://github.com/EGroupware/egroupware/wiki/19.1-Release-notes-and-distribution-specific-instructions/_edit#opensuse-151--150-or-sles-15--12) 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:/trunk/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. +