web,etherpad: add etherpad addon for sharing document

Makefile

@@ -2,7 +2,7 @@ FORCE_REBUILD ?= 0
 JITSI_RELEASE ?= stable
 JITSI_BUILD ?= latest
 JITSI_REPO ?= jitsi
-JITSI_SERVICES ?= base base-java web prosody jicofo jvb jigasi
+JITSI_SERVICES ?= base base-java web prosody jicofo jvb jigasi etherpad
 
 ifeq ($(FORCE_REBUILD), 1)
   BUILD_ARGS = "--no-cache"

README.md

@@ -35,7 +35,10 @@ follow these steps:
   a different port, in case you edited the compose file).
 
 If you want to use jigasi too, first configure your env file with SIP credentials
-and then run Docker Compose as follows: ``docker-compose -f docker-compose.yml -f jigasi.yml up -d``
+and then run Docker Compose as follows: ``docker-compose -f docker-compose.yml -f jigasi.yml up``
+
+If you want to enable document sharing via [Etherpad], configure it and run Docker Compose as
+follows: ``docker-compose -f docker-compose.yml -f etherpad.yml up``
 
 ## Architecture
 
@@ -199,6 +202,17 @@ This can be tested using the [jwt.io] debugger. Use the following samople payloa
 }
 ```
 
+### Shared document editing using Etherpad
+
+You can collaboratively edit a document via [Etherpad]. In order to enable it, set the config options bellow and run
+Docker Compose with the additional config file `etherpad.yml`.
+
+Here are the required options:
+
+Variable | Description | Example
+--- | --- | ---
+`ETHERPAD_URL_BASE` | Set etherpad-lite URL | http://etherpad.meet.jitsi:9001
+
 ### Advanced configuration
 
 These configuration options are already set and generally don't need to be changed.
@@ -270,4 +284,5 @@ option.
 [ICE]: https://en.wikipedia.org/wiki/Interactive_Connectivity_Establishment
 [STUN]: https://en.wikipedia.org/wiki/STUN
 [jwt.io]: https://jwt.io/#debugger-io
+[Etherpad]: https://github.com/ether/etherpad-lite
 

docker-compose.yml

@@ -24,6 +24,7 @@ services:
             - XMPP_BOSH_URL_BASE
             - XMPP_GUEST_DOMAIN
             - XMPP_MUC_DOMAIN
+            - ETHERPAD_URL_BASE
             - TZ
         networks:
             meet.jitsi:

env.example

@@ -33,6 +33,14 @@ TZ=Europe/Amsterdam
 #LETSENCRYPT_EMAIL=alice@atlanta.net
 
 
+#
+# Etherpad integration (for document sharing)
+#
+
+# Set etherpad-lite URL (uncomment to enable).
+#ETHERPAD_URL_BASE=http://etherpad.meet.jitsi:9001
+
+
 #
 # Basic Jigasi configuration options (needed for SIP gateway support)
 #

etherpad.yml

@@ -0,0 +1,10 @@
+version: '3'
+
+services:
+    # Etherpad: real-time collaborative document editing
+    etherpad:
+        image: jitsi/etherpad
+        networks:
+            meet.jitsi:
+                aliases:
+                    - etherpad.meet.jitsi

etherpad/Dockerfile

@@ -0,0 +1,5 @@
+FROM etherpad/etherpad
+
+ADD ./rootfs/defaults/settings.json /opt/etherpad-lite/settings.json
+
+EXPOSE 9001

etherpad/Makefile

@@ -0,0 +1,4 @@
+build:
+	docker build $(BUILD_ARGS) -t jitsi/etherpad .
+
+.PHONY: build