jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-05-04 10:08:57 +00:00
Code Issues Packages Projects Releases Wiki Activity
home-assistant.io/source/_integrations/mqtt.markdown
Thorjan Knudsvik 8724f0c60e
MQTT Setup via UI (#12802) 
MQTT is possible to set up from the UI and is thus the preferred option of setup.
2020-04-11 10:50:14 +02:00

1.8 KiB
Raw Blame History

title, description, ha_category, featured, ha_release, ha_iot_class, ha_config_flow, ha_codeowners, ha_domain
title description ha_category featured ha_release ha_iot_class ha_config_flow ha_codeowners ha_domain
MQTT Instructions on how to setup MQTT within Home Assistant.
Hub
true pre 0.7 Local Push true
@home-assistant/core
mqtt

MQTT (aka MQ Telemetry Transport) is a machine-to-machine or "Internet of Things" connectivity protocol on top of TCP/IP. It allows extremely lightweight publish/subscribe messaging transport.

Your first step to get MQTT and Home Assistant working is to choose a broker.

The preferred way to setup MQTT for your installation is via Configuration >> Integrations in the UI, click the button with + sign and from the list of integrations select MQTT.

Alternatively, if you want to manually configure MQTT, you will need to add the following to your configuration.yaml file.

To connect to your own MQTT broker:

# Example configuration.yaml entry
mqtt:
  broker: IP_ADDRESS_BROKER

You can also use the embedded MQTT broker. A separate broker is advised for more stability.

As of release 0.92, the embedded broker has been marked as deprecated. This means bugs may not be fixed, and the broker functionality will be removed in a future release. 
# Example configuration.yaml entry
mqtt:
  password: hello

This allows you to connect to the MQTT broker with user homeassistant and password hello.

Additional features