jenskuersten / monitor.sh

Quick reference

• Where to file issues with docker image: monitor.sh docker image github

• Monitor source:
  andrewjfreyer/monitor Github

• Monitor forum thread:
  Home Assistant forum thread

What is Monitor.sh?

Bluetooth-based passive presence detection of beacons, cell phones, and any other bluetooth device. The system is useful for mqtt-based home automation.

How to use this image

Configuration

When running the image, the default configuration is stored in /config. To use custom configuration, mount a local configuration directory to /config

First run

$ docker run -it --rm --net=host --cap-add=NET_ADMIN -v /local/config/:/config monitor.sh

Use an empty local directory as a config dir - on first run the script will create empty configuration file that you have to edit:

known_beacon_addresses  
known_static_addresses   
mqtt_preferences

Running the image

--net=host is needed so the script will have access to hci0 --cap-add=NET_ADMIN is needed so that the script can cycle the hci0 bluetooth interface

$ docker run -it -d --net=host --cap-add=NET_ADMIN -v /local/config/:/config monitor.sh

Running with different options

You can add different script options (refer to the script readme file)

$ docker run -it -d --net=host --cap-add=NET_ADMIN -v /local/config/:/config monitor.sh bash monitor.sh -b -g

Displaying help / Running one-off commands

$ docker run -it --rm --net=host --cap-add=NET_ADMIN -v /local/config/:/config monitor.sh bash monitor.sh -h

Create a local image to be used in docker (compose)

Build image in local docker registry

docker build . -t monitor.sh:latest

Integrate into docker compose file

services:
  monitor.sh:
    image: monitor.sh # local image created from repos folder
    container_name: monitor.sh
    pull_policy: never # allows to run docker compose pull in a stack