markdown-body entry-content container-lg" itemprop="text">

MQTT collector

Collect data from MQTT broker and push it to InfluxDB 2. The mappings of MQTT topics to InfluxDB fields and measurements is customizable.

The main use case is to collect data for SOLECTRUS, but it can be used for other purposes as well, where you want to collect data from MQTT and store it in InfluxDB.

It has been tested in the following setups:

ioBroker with the integrated MQTT broker and the SENEC Home 2.1 adapter
evcc with the senec-home template and the HiveMQ MQTT Broker

Note: For a SENEC device there is a dedicated senec-collector available which communicates directly with the SENEC device via its API and does not require a MQTT broker. Also, it is able to collect additional and more accurate data from the SENEC device.

Requirements

InfluxDB 2
MQTT broker
Linux machine with Docker installed

Getting started

Make sure that your MQTT broker and InfluxDB2 database are ready (not subject of this README)
Prepare an .env file (see .env.example)
Run the Docker container on your Linux box:
```
docker compose up
```

The Docker image supports multiple platforms: linux/amd64, linux/arm64, linux/arm/v7

Development

For development you need a recent Ruby setup. On a Mac, I recommend rbenv.

Run the app

bundle exec app.rb

Run tests

bundle exec rake

Run linter

bundle exec rubocop

License

Copyright (c) 2023-2025 Georg Ledermann georg@ledermann.dev and contributors.
Inspired by code provided by Sebastian Löb (@loebse) and Michael Heß (@GrimmiMeloni)

Uh oh!

License

solectrus/mqtt-collector

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 13

Sponsor this project

Uh oh!

Packages 0

Uh oh!

Uh oh!

Contributors 5

Uh oh!

Languages

Packages