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 23.3:


This is the 15th release of ebusd 3 and the 24th (="X", therefor Xanthophyllum) since ebusd was completely reworked.

The major new features are a reqorked eBUS protocol engine, time fields for MQTT integration, removed dependency on libargp, as well as a bunch of bug fixes.

See ChangeLog and Wiki for details.

Debian 12 (Bookworm), 11 (Bullseye), and 10 (Buster) 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.

For convenience, an armv6l (Raspberry Pi 1 and Zero/Zero W) Buster image is attached here as well (not part of the Debian repository though).

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

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.