mirror of https://github.com/EGroupware/egroupware.git synced 2024-12-26 16:48:49 +01:00

History

Ralf Becker 18bd4b7e92 several fixes / additions for 20.1 container		2020-06-14 14:11:58 +02:00
..
build.sh	remove wrong quotes in Watchtower example config and adding (commented out) Portainer	2020-04-02 21:56:23 +02:00
docker-compose.yml	requiring push server for master and adding it to docker-composer	2020-06-13 15:14:30 +02:00
Dockerfile	several fixes / additions for 20.1 container	2020-06-14 14:11:58 +02:00
entrypoint.sh	changes to build additional PHP 7.4 images, also tagging by full version eg. 7.3.12	2019-11-30 15:34:09 +02:00
nginx.conf	remove wrong quotes in Watchtower example config and adding (commented out) Portainer	2020-04-02 21:56:23 +02:00
README.md	updated Readm	2020-02-09 19:16:28 +01:00

README.md

EGroupware development enviroment as Docker container

The container and docker-compose.yml file in this directory are the most easy way to get a full development enviroment for EGroupware.

It defines and uses the following volumes:

sources: document root of the webserver, by default $PWD/sources subdirectory, can also be your existing document root
data: EGroupware stores it's files here, by default $PWD/data subdirectory, can also be your existing /var/lib/egroupware
db: volume for MariaDB (should be NOT a directory under Mac OS and Windows for performance reasons!)
sessions: volume for sessions, internal no need to change
sources-push: swoolpush sub-directory of sources
collabora-config: /etc/loolwsd for Collabora container, by default $PWD/data/default/loolwsd
rocketchat-uploads: Upload directory for Rocket.Chat, by default $PWD/data/default/rocketchat/uploads
rocketchat-dumps: Dump directory for MongoDB, by default $PWD/data/default/rocketchat/dump

It runs the following containers:

egroupware: php-fpm
egroupware-nginx: Nginx
egroupware-db: MariaDB
egroupware-push: PHP Swoole based push server
egroupware-watchtower: to automatic keeps the containers up to date
collabora: Collabora Online Office
rocketchat: Rocket.Chat
rocketchat-mongo: MongoDB for Rocket.Chat

Usage:

mkdir dev && cd dev
wget https://raw.githubusercontent.com/EGroupware/egroupware/master/doc/docker/development/docker-compose.yml
wget https://raw.githubusercontent.com/EGroupware/egroupware/master/doc/docker/development/nginx.conf
mkdir sources data
# edit docker-compose.yml to fit your needs eg.
# ports to use for Nginx / the webserver, by default 8080 and 4443
# xdebug port, default 9001 (NOT 9000!)
# IDE host, default XDEBUG_REMOTE_HOST=docker.for.mac.localhost
docker-compose up -d

It will install EGroupware master and phpMyAdmin in egroupware / phpmyadmin subdirectory of sources volume, if not already there
Credentials for a new install can be found in data:egroupware-docker-install.log
Use the following to tail the webserver error.log

docker logs -f egroupware-nginx 2>&1 | sed "s/PHP message/\\$(echo -e '\n\r')PHP message/g"

Docker Desktop for Mac notes

directories of volumes must be exported to Docker, by default only your home-directory is!
permissions of sources and data directory must be readable (sources writable) by your user, as Docker daemon runs as that user!
db volume must NOT be a directory, as the networked access from Docker VM to the Mac is to slow!

Docker Desktop for Windows notes

you can NOT use $PWD to reference the docker-compose directory, use the full path with forward slashes!
directories of volumes must be exported to Docker!
db volume must NOT be a directory, as the networked access from Docker VM to Windows is to slow!

Docker on Linux

permissions of sources and data directory must be readable (sources writable) by www-data user (#33)