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-04-30 16:27:37 +00:00
Code Issues Packages Projects Releases Wiki Activity
home-assistant.io/source/_integrations/mqtt.markdown
zraken f3fccc0624
Update mqtt.markdown (#17227) 
Co-authored-by: Franck Nijhof <frenck@frenck.nl>
2021-04-04 22:15:31 +02:00

1.5 KiB
Raw Blame History

title description ha_category featured ha_release ha_iot_class ha_config_flow ha_codeowners ha_domain ha_platforms
MQTT Instructions on how to setup MQTT within Home Assistant.
Hub
true pre 0.7 Local Push true
@emontnemery
mqtt
alarm_control_panel
binary_sensor
camera
climate
cover
fan
lock
sensor
switch

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.

{% include integrations/config_flow.md %}

Manual configuration

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

Manual configuration is required when connecting to a broker over TLS.

# Example configuration.yaml entry
mqtt:
  certificate: "PATH_TO_CA.crt"
  broker: "IP_ADDRESS_BROKER"
  port: 8883
  username: "MQTT_USERNAME"
  password: !secret MQTT_PASSWORD

Additional features