# Home Assistant Core

Integration Key: homeAssistant

The Home Assistant Core (opens new window) integration shares data with the home automation software over MQTT (opens new window).

# Requirements

TIP

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 (opens new window) to get started quickly.

room-assistant makes use of the MQTT auto discovery (opens new window) 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.

# Settings

Name Type Default Description
mqttUrl String mqtt://localhost:1883 Connection string for your MQTT broker.
mqttOptions MQTT Options Additional options for the MQTT connection.
sendAttributes Boolean true 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.
sendMqttRoom Boolean false Whether entities with distances should publish them in the MQTT Room integration (opens new window) format or not.
discoveryPrefix String homeassistant The prefix for the discovery topic that Home Assistant will watch.
mqttRoomPrefix String room-assistant/mqtt-room The topic prefix that will be used for the MQTT Room (opens new window) messages, should match state_topic in Home Assistant.

# MQTT Options

Name Type Default Description
username String Username for authentication
password String Password for authentication
rejectUnauthorized Boolean true Whether MQTTS connections should fail for invalid certificates or not. Set this to false if you are using a self-signed certificate and connect via TLS.
Example Config
global:
  integrations:
    - homeAssistant
homeAssistant:
  mqttUrl: mqtt://homeassistant.local:1883
  mqttOptions:
    username: youruser
    password: yourpass
  discoveryPrefix: homeassistant