MQTT is used as a broker/intermediary for the data leaving Grott. Grott pushes the data to MQTT then Home Assistant registers with the MQTT service to be notified whenever new data is available. You can read a lot more about MQTT here. For the purposes of this setup, you can just use the most basic configuration, outlined below.
MQTT can be set up in a variety of ways, below outlines 2 potential options:
- Docker
- Local install
To run MQTT as a docker container you can the following command:
docker run -d -v <path_to_mqtt_dir>/config:/mosquitto/config -v <path_to_mqtt_dir>/data:/mosquitto/data -v <path_to_mqtt_dir>/log:/mosquitto/log -p 1883:1883 eclipse-mosquitto
Where <path_to_mqtt_dir>
is replaced with the path locally for a directory to store anything persistent e.g. configuration files and data, please see the configuration section below for what should appear in the configuration file
See docker-compose guide for a more complete docker deployment method
Install relevant version from this page: https://www.mosquitto.org/download/
Installation instructions should be included with their respective binaries
MQTT requires the most basic of configurations in order to work with Grott.
A configuration file (<path_to_mqtt_dir>/config/mosquitto.conf
) should be created with the following contents:
allow_anonymous true
listener 1883
persistence true
persistence_location /mosquitto/data/
log_dest file /mosquitto/log/mosquitto.log
NOTE: This assumes the default path for the docker container, replace with the path to your MQTT installation if you followed the Local install steps
At this point you should now have a running Grott server and a running MQTT instance, Grott should already be forwarding data to MQTT if you configured the correct ip
and port
in the grott setup