extern/egroupware
1
0
Fork 1
mirror of https://github.com/EGroupware/egroupware.git synced 2024-11-22 16:03:27 +01:00
Code Issues Packages Projects Releases Wiki Activity

First version of 19.1 installation instructions

Ralf Becker 2019-07-16 19:56:52 +02:00
parent f26872db5e
commit 00200df14e
1 changed files with 82 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

82
19.1--Installtion-using-egroupware-docker-RPM-DEB-package.md Normal file

@ -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: <your-username>
Password: <your-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 <git-url>
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.