Extend docker README.md

doc/docker/README.md

@@ -8,8 +8,12 @@
 curl https://raw.githubusercontent.com/EGroupware/egroupware/master/doc/docker/docker-compose.yml > docker-compose.yml
 curl https://raw.githubusercontent.com/EGroupware/egroupware/master/doc/docker/nginx.conf > nginx.conf
 # edit docker-compose.yml or nginx.conf, by default it will run on http://localhost:8080/
+# create a few directories upfront, otherwise the containers won't start up:
 mkdir data # this is where egroupware data is stored, it's by default a subdir of the directory of docker-compose.yml
 mkdir -p data/default/loolwsd # this is where collabora config is stored
+mkdir -p data/default/rocketchat/dump # rocket.chat dumps
+mkdir -p data/default/rocketchat/uploads # rocket.chat uploads
+mkdir sources # egroupware sources will show up in this folder
 docker-compose up -d
 ```
 ## More information
@@ -27,9 +31,19 @@ The provided docker-compose.yml will run the following container:
 ```
 version: '3'
 volumes:
+  # NOTE: all directories referenced by "device" entries below need to be created manually before starting the containers
+  # egroupware sources
   sources:
-  # you can use either an anonymous volume, or explicitly specify an existing (!) path
+    driver_opts:
-  # device: $PWD/sources
+      type: none
+      o: bind
+      device: $PWD/sources/
+  # sources for push server, swoolepush is a subdirectory of egroupware sources (within volume "sources")
+  sources-push:
+    driver_opts:
+      type: none
+      o: bind
+      device: $PWD/sources/egroupware/swoolepush
   db:
   data:
     driver_opts:
@@ -48,16 +62,11 @@ volumes:
   #    # location of deprecated EGroupware packages like Wiki, SiteMgr, KnowledgeBase
   #    device: /usr/share/egroupware
   #    #device: $PWD/extra
-  # sources for push server, swoolepush subdirectory of egroupware sources, in volume "sources"
-  sources-push:
-    driver_opts:
-      type: none
-      o: bind
-      device: $PWD/sources/egroupware/swoolepush
   # volume to store config.inc.php file / token shared between egroupware and push container
   push-config:
   sessions:
   # collabora-config directory, initially filled by collabora-init container
+  # additionally some more configuration files are needed in order for collabora to work, which are _not_ generated by the collabora-init container
   collabora-config:
     driver_opts:
       type: none
@@ -136,6 +145,8 @@ services:
     image: phpswoole/swoole:php8.1-alpine
     command:
       - /var/www/server.php
+    environment:
+      EGW_MAX_PUSH_USERS: 1024
     volumes:
       - sources-push:/var/www
       - sessions:/var/lib/php/sessions
@@ -170,10 +181,11 @@ services:
 
   # run an own MariaDB:10.4 (you can use EGroupware's database backup and restore to add your existing database)
   db:
-    image: mariadb
+    image: mariadb:10.6
     environment:
     #- MYSQL_ROOT=root
     - MYSQL_ROOT_PASSWORD=secret
+    - MARIADB_AUTO_UPGRADE=true
     volumes:
     - db:/var/lib/mysql
     container_name: egroupware-db
@@ -285,4 +297,4 @@ services:
 #      - /var/run/docker.sock:/var/run/docker.sock
 #      - portainer_data:/data
 #    container_name: portainer
-```
+```