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 building your own eBUS adapter, that is needed for connecting ebusd to your heating system.

Current Version 3.2:


This is the third release of ebusd 3 and the twelfth (="L", therefor Lime) since ebusd was completely reworked.

Major new features include retrieval of configuration files from the config web service (default enabled), automatic reconnects to MQTT broker, new options to read/write commands for dynamic message definition testing, the new "define" command for adding message defintitions during runtime (default disabled), as well as the new "encode" and "decode" test commands.

See ChangeLog and Wiki for details.

Debian install packages for amd64 (Debian Stretch and Jessie), i386 (Debian Jessie), and armhf (Raspberry Pi on Debian Jessie and Wheezy) are attached.

Variants of each binary with MQTT support have an additional "mqtt0" (for libmosquitto0) or "mqtt1" (for libmosquitto1) suffix in the name.

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

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.