Skip to content

thomasddn/qbusmqtt

Repository files navigation

QBUSMQTT

Exposes states and events of the Qbus Home Automation system to a MQTT broker.

It is also available as a Home Assistant add-on: https://github.com/thomasddn/home-assistant-addons.

GitHub release (with filter)

Supports amd64 Architecture Supports arm Architecture Supports i386 Architecture

🥤 Snack-fueled coding

You know what goes great with open-source coding? Snacks! If my project helped you out, maybe throw a little something my way so my potato chips and Coca-Cola stash doesn't run out!

ko-fi

🛠️ Setup

Prerequisites

Installation

  1. Create docker-compose.yaml
  2. Adjust environment variables as needed
  3. Start the container: docker compose up -d

Example docker-compose.yaml:

services:
  qbusmqtt:
    image: thomasddn/qbusmqtt:latest
    container_name: qbusmqtt
    restart: unless-stopped
    network_mode: host          # Must be host so it can discover the controller
    environment:
      MQTT_HOST: 192.168.0.123
      MQTT_PORT: 1883
      MQTT_USER: user
      MQTT_PWD: secret
      TZ: Europe/Brussels

Configuration

Key Required Default value Description
MQTT_HOST Y <empty> The IP or host name of the MQTT broker.
MQTT_PORT N 1883 The port of the MQTT broker.
MQTT_USER N <empty> The username to connect to the MQTT broker.
MQTT_PWD N <empty> The password to connect to the MQTT broker.

🗣️ Remarks

⚠️ This is not officially supported by Qbus.