My OpenHab project

In this repository I share my OpenHab2 configuration files.

Short description of the setup

I run my OpenHab2 automation on the Raspberry Pi 2 Model B. It includes:

I use Raspberry Pi 2B+ with "Raspbian GNU/Linux 10 (buster)" distribution there.

In order to improve system stability and performance I connected external SSD via USB port to the Raspberry and moved (via symlink) all large and regularly updated logs there:

MQTT (Mosquitto) logs
NGINX logs
Openhab logs
Letsencrypt logs

Following defices are connected and automated in my OpenHab2 automation setup:

ZigBee devices integrated via Zigbee2MQTT bridge:
- Xioami Aqara contact sensors for doors and windows (Zigbee).
- Xiaomi Aqare temperature and humidity sensors.
User location tracking with OwnTracks application on smartphones:
- OwnTracks is connected to MQTT bus via TLS protected connection.
TP-Link HS100 SmartPlug (WiFi)
Fritz!Box 7490:
- MAC addresses presence tracking.
- Guest Wi-Fi ON/OFF control.

To collect metrics and present them I use InfluxDB and Grafana in Docker containers. InfluxDB also provides me persistence for the OpenHab. For the initial setup of the InfluxDB I used following tutorial: Setting up InfluxDB and Grafana using Docker. While this tutorial is on the Home Assistant page, this works for OpenHab as well.

All OpenHab configuration I do via config files, not GUI. This approach is more robust and also gives you ability to migrate OpenHab configuration to other system.

Additional information:

NGINX and Mosquitto are exposed via IPv4 and IPv6 connections (Dual Stack).
OpenHab is behind Nginx reverse proxy with TLS authentication Let's Encrypt.
The same TLS certificates are used by Mosquitto.
- It is importanto to mention, that Mosquitto DOES NOT work correctly with IPv6 via WebSockets. Therefore I am using standard Mosquitto protocol with TLS protection.
Connection to Telegram messenger channel for notifications.
I use Basic UI for the web-page.
On the smart phone I use OpenHab App beta. It works fine. But if you do not like "beta" in the name, you can use stable release version instead: OpenHab App.

Containers

I run Grafana, InfluxDB and Zigbee2mqtt in docker containers. In order to avoid complicated networking setup, I use host networking for all of them. To launch containers I use following docker-compose.yml file:

version: "3.7"
services:
    
    db:
        image: influxdb:latest 
        container_name: influxdb_openhab
        restart: always
        network_mode: host
        volumes:
            - <your path to folder with influxdb files>:/var/lib/influxdb

    front:
        image: grafana/grafana:latest
        container_name: grafana_openhab
        restart: always
        network_mode: host
        depends_on:
            - db
        volumes:
            - grafana-storage:/var/lib/grafana

    zigbee2mqtt:
        image: koenkk/zigbee2mqtt:1.6.0-arm32v6
        container_name: zigbee2mqtt
        restart: always
        network_mode: host
        volumes:
            - <your path to data folder with zigbee2mqtt configuration>:/app/data
        devices:
            - /dev/ttyACM0:/dev/ttyACM0

volumes:
    grafana-storage:
        external: true
        name: grafana-storage

I created docker volume with the name grafana-storage for the Grafana files. You can also use docker volume for InfluxDB files.

If you do not want to use docker-compose for containers management (for some reason), you can use following equivalent command line commands:

docker run -d --restart always \
	--name=influxdb_openhab
	--volume=<your path to folder with InfluxDB files>:/var/lib/influxdb \
	--network host influxdb

docker run -d --restart always \
	--name=grafana_openhab --volume=grafana-storage:/var/lib/grafana \
	--network host grafana/grafana

docker run -d --restart always \
	--name=zigbee2mqtt --volume=<your path to data folder with zigbee2mqtt configuration>:/app/data \
	--device=/dev/ttyACM0:/dev/ttyACM0 \
	--network host koenkk/zigbee2mqtt:1.6.0-arm32v6

Before you are going to bring up containers first time using this compose file, you shall create docker volume for Grafana using following command:

docker create volume grafana-storage

Or you can use direct path mapping for Grafana volume, the same way as for InfluxDB. Then you have just create a folder for Grafan on your drive and map it to the container's directory /var/lib/grafana.

alexeygumirov/openhab

My OpenHab project

Short description of the setup

Containers