ebusd is a daemon for handling communication with eBUS devices connected to a 2-wire bus system (“energy bus” used by numerous heating systems).

Releases, source code, and documentation are available on github:


In principle, ebusd is handling all the low level traffic aspects on the bus and allows a high level access to sending/receiving messages and revealing their content.

See here for details on a decent eBUS adapter, that is needed for connecting ebusd to your heating system.

Current Version 21.3:


This is the eighth release of ebusd 3 and the sixth (="Q", therefor Quince) since ebusd was completely reworked.

The major new features are more data types, support for verbose output publishing in MQTT and newer MQTT broker versions, as well as added and extended HTTP JSON endpoints.

See ChangeLog and Wiki for details.

Debian 11 (Bullseye), 10 (Buster), and 9 (Stretch) install packages for amd64, 386, armv7 (Raspberry Pi 2/3/4), and arm64 (Raspberry Pi 3/4 64 bit) are attached and will also be made available soon in the Debian repository as described here.

Variants of each binary with MQTT support have an additional "mqtt1" (for libmosquitto1) suffix in the name. Those without MQTT support don't have such a suffix.

For Arch Linux, simply run makepkg in the contrib/archlinux/ebusd/ directory.

The latest release is also available as multi-architecture Docker image on the hub with tag ebusd:latest.

Corresponding CSV configuration files:

Usage with ebusd version 3.2 or higher:

If you’re using ebusd in version 3.2 or higher, you can simply use the default option for the location of the configuration files that are served by ebusd.eu (see “–configpath” option).
Due to this new feature, no more packaged releases of this repository will be generated in future. If you intend to work on the configuration yourself, simply checkout this repository and point ebusd to your local folder with the latest version.

Latest release (for ebusd older than 3.2):

ebusd 2.1 config 2016/06/05

This is the second release of ebusd 2.1 configuration files for easy installation on e.g. Debian.

The major new feature of this release compared to 2.0 is the support for a variety of different Vaillant BAI devices. Compared to the first 2.1 release, the missing ".inc" files were added to the ".deb" files and 370 as well as F37 devices were added.

Installation on Debian:

  1. Download one of the ".deb" files with your desired language code
  2. Run "*dpkg -i --force-overwrite ebusd-configuration-2.1..deb**" Note: The "--force-overwrite" option is necessary since the ebusd package already contains a rough "broadcast.csv", which is also contained in this package.

Installation on other OS:

  1. Download one of the ".tgz" files with your desired language code
  2. Remove old files/directories from the /etc/ebusd directory
  3. Unpack it to the /etc/ebusd directory using "*tar xzf ebusd-configuration-2.1..tgz -C /etc/ebusd/**"

See previous versions here.