Install Mosquitto MQTT Broker

Use this guide to install the Mosquitto broker add-on and confirm that MQTT is available in Home Assistant.

Install the Add-on

1. In Home Assistant, go to Settings > Apps > Install App.
2. Search for Mosquitto broker.
3. Select Install.
4. After installation completes, enable Start on boot, Watchdog, and Auto-update.
5. Select Start.
6. Open the Log tab and confirm the broker starts successfully.

Optional: Create a Dedicated MQTT User

If a project needs a dedicated MQTT user for another app or integration:

1. Go to Settings > People > Users.
2. Create the user that will be used for the MQTT connection.
3. Save the credentials in the approved password-management workflow.

Before moving on

1. Go to Settings > Devices & Services.
2. If MQTT appears as a discovered integration, open it and finish setup.
3. If it does not appear automatically, add it manually through + Add Integration.
4. Confirm the MQTT integration is loaded before you continue with any app that depends on it.