Docker Hub

To download the image from Docker Hub you can run the following:

docker pull bmartin5692/bumper

View Bumper on Docker Hub

Build a Docker image

To build the docker image yourself you can run the following: docker build -t bmartin5692/bumper .

This requires Docker 17.09 or newer, but has also been tested with podman.

Docker usage

To run the image in docker some environment settings and port mappings are required:

Ports Required: (-p)

443 - -p 443:443
8007 - -p 8007:8007
8883 - -p 8883:8883
5223 - -p 5223:5223

Environment Settings: (-e)

BUMPER_ANNOUNCE_IP should be used so the actual host IP is reported to bots that checkin.

BUMPER_ANNOUNCE_IP - -e "BUMPER_ANNOUNCE_IP=X.X.X.X"

Volume Settings: (-v)

Optionally you can map existing directories for logs, data, and certs.

data/logs/certs
Data - -v /home/user/bumper/data:/bumper/data

Full Example:

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

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.

---
version: "3.6"

networks:
  bumper:
    internal: true

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:

    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

File stored under ./nginx/nginx.conf

error_log stderr;
pid /var/run/nginx.pid;

events { }

stream {
        resolver 127.0.0.11 ipv6=off; #docker dns server
        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;
                proxy_pass bumper:$internalport;
        }

        server {
                listen 5223;
                proxy_pass bumper:5223;
        }

        server {
                listen 8007;
                proxy_pass bumper:8007;
        }

        server {
                listen 8883;
                proxy_pass bumper:8883;
        }
}

File structure

When ure are using the docker-compose example, you will have a similar file structure as below

.
├── certs
│   ├── bumper.crt
│   ├── bumper.csr
│   ├── bumper.key
│   ├── ca.crt
│   ├── ca.csr
│   ├── ca.key
│   ├── ca.srl
│   ├── certconfig_bumper.txt
│   ├── certconfig_ca.txt
│   ├── commands.md
│   ├── create_bumper.sh
│   ├── create_ca.sh
│   ├── csrconfig_bumper.txt
│   └── csrconfig_ca.txt
├── config
│   ├── bumper.db
│   └── passwd
├── docker-compose.yml
└── nginx
    └── nginx.conf

3 directories, 18 files

4.1 KiB Raw Blame History