Home Assistant Core
Running on Home Assistant OS? If you are also using the MQTT server add-on room-assistant will automatically pick up the correct credentials - no configuration needed!
You will need to setup an MQTT broker that both your instance of Home Assistant Core and all instances of room-assistant can connect to. If you are using Home Assistant OS you can install the official mosquitto add-on to get started quickly.
room-assistant makes use of the MQTT auto discovery features provided by Home Assistant Core to automatically create all entities for you. It is strongly recommended that you enable this feature when setting up the MQTT integration in Home Assistant Core.
|String||Connection string for your MQTT broker.|
|MQTT Options||Additional options for the MQTT connection.|
|Boolean||Whether entity attributes should be forwarded to Home Assistant or not. May be disabled to reduce the number of messages that Home Assistant needs to process.|
|Boolean||Whether entities with distances should publish them in the MQTT Room integration format or not.|
|String||The prefix for the discovery topic that Home Assistant will watch.|
|String||The topic prefix that will be used for the MQTT Room messages, should match |
|String||Username for authentication|
|String||Password for authentication|
|Boolean||Whether MQTTS connections should fail for invalid certificates or not. Set this to |
Some of these settings may also be configured as environment variables, using
global: integrations: - homeAssistant homeAssistant: mqttUrl: mqtt://homeassistant.local:1883 mqttOptions: username: youruser password: yourpass discoveryPrefix: homeassistant