From 63330a6a459f20d260ede003c748f2716bf87287 Mon Sep 17 00:00:00 2001
From: Robert Resch <robert@resch.dev>
Date: Mon, 19 Apr 2021 21:18:29 +0200
Subject: [PATCH] add docker-compose example

---
 docs/Docker.md | 106 ++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 105 insertions(+), 1 deletion(-)

diff --git a/docs/Docker.md b/docs/Docker.md
index d6cc839..85eb7a4 100644
--- a/docs/Docker.md
+++ b/docs/Docker.md
@@ -41,4 +41,108 @@ Optionally you can map existing directories for logs, data, and certs.
 
 ````
 docker run -it -e "BUMPER_ANNOUNCE_IP=X.X.X.X" -p 443:443 -p 8007:8007 -p 8883:8883 -p 5223:5223 -v /home/user/bumper/data:/bumper/data --name bumper bmartin5692/bumper
-````
\ No newline at end of file
+````
+
+# Docker-compose
+
+Below a docker-compose example with an nginx proxy, which redirects mqtt traffic on port `443` to port `8883`
+The redirection is required as the app v2+ and robots with a newer firmware are connecting to the mqtt server on port 433.
+
+```yaml
+---
+version: "3.6"
+
+networks:
+  bumper:
+    internal: true
+    ipam:
+      config:
+        - subnet: 172.19.200.0/24
+
+services:
+  nginx:
+    depends_on:
+      - bumper
+    image: nginx:alpine
+    networks:
+      default:
+      bumper:
+    expose:
+      - 443
+      - 5223
+      - 8007
+      - 8883
+    restart: unless-stopped
+    volumes:
+      - /etc/timezone:/etc/timezone:ro
+      - /etc/localtime:/etc/localtime:ro
+      - ./nginx/:/etc/nginx:ro # See config file below
+
+  bumper:
+    image: bmartin5692/bumper
+    restart: unless-stopped
+    networks:
+      bumper:
+        ipv4_address: 172.19.200.10
+
+    environment:
+      PUID: 1000
+      PGID: 1000
+      TZ: Europe/Rome
+      BUMPER_ANNOUNCE_IP: XXX # Insert your IP
+      BUMPER_LISTEN: 0.0.0.0
+      # BUMPER_DEBUG: "true"
+      LOG_TO_STDOUT: "true"
+    volumes:
+      - /etc/timezone:/etc/timezone:ro
+      - /etc/localtime:/etc/localtime:ro
+      - ./config:/bumper/data
+      - ./certs:/bumper/certs
+```
+
+## Nginx configuration
+
+```
+error_log stderr;
+pid /var/run/nginx.pid;
+
+events { }
+
+stream {
+        map_hash_bucket_size 64;
+
+        map $ssl_preread_server_name $internalport {
+                # redirect all requests, which contain "mq" in the SNI -> MQTT
+                ~^.*(mq).*\.eco(vacs|user)\.(net|com)$    8883;
+
+                # the rest of eco(user|vacs) requests
+                ~^.*\.eco(vacs|user)\.(net|com)$          443;
+
+                # mapping default to MQTT as the bots are connecting directly to the ip without SNI
+                default                                   8883;
+        }
+
+        server {
+                listen 443;
+                ssl_preread  on;
+                # Ip must match the one configurated above in the docker-compose
+                proxy_pass 172.19.200.10:$internalport;
+        }
+
+        server {
+                listen 5223;
+                proxy_pass 172.19.200.10:5223;
+        }
+
+        server {
+                listen 8007;
+                proxy_pass 172.19.200.10:8007;
+        }
+
+        server {
+                listen 8883;
+                proxy_pass 172.19.200.10:8883;
+        }
+}
+
+```
\ No newline at end of file