Add-ons are separate apps that run next to Home Assistant. Each one runs in its own container, and the Supervisor installs, updates and manages them. You can find them under Settings > Apps on Home Assistant OS (older releases call this Add-ons).
Add-ons, integrations and HACS
These three things are easy to mix up:
- Add-ons run extra software beside Home Assistant. Mosquitto and Node-RED are examples.
- Integrations connect Home Assistant to devices or services. A Hue bridge or the MQTT integration are examples.
- HACS is a store for custom integrations, cards and themes. It is not an add-on. Our HACS guide explains how to install it.
Installing an add-on does not automatically create devices or entities. Some add-ons need an integration afterwards. For example, the Mosquitto add-on pairs with the MQTT integration.
Which install types have add-ons
Add-ons are available on Home Assistant OS, and on Supervised installs. Container and Core installs don’t have an add-on store. Those setups can run the same software as separate Docker containers.
Popular add-ons
Official add-ons include:
- Mosquitto broker
- File editor
- Terminal & SSH
- Samba share
- ESPHome Device Builder
- Z-Wave JS
- Matter Server
- MariaDB
Popular community add-ons include:
- Studio Code Server
- Node-RED
- AdGuard Home
- Zigbee2MQTT and Frigate, which are installed from their own repositories
If you run a broker for your devices, do you need MQTT for Home Assistant? explains when Mosquitto is needed.
How to install an add-on
- Go to Settings > Apps and open the App store (older releases call this the Add-on Store).
- Select an add-on, then select Install.
- Open the Configuration tab and set any required options. You can enter them as YAML or in the form.
- Turn on Start on boot, Watchdog or Show in sidebar if you want them.
- Select Start, then open the Log tab and check for errors.
Add a third-party repository
To install an add-on from outside the store, open the three-dot menu in the App store, select Repositories, and paste the repository URL. Only add repositories you trust. Add-ons can get broad access to your system.
After you install
- Backups include add-ons. Full and selective backups both cover them.
- Add-ons use memory and processor time. A Raspberry Pi 4 or 5 with 4 GB or more handles a typical set of add-ons better than one with 2 GB.
- Some add-ons need setup in other places. After you install Mosquitto, for example, Home Assistant finds the MQTT integration for you to accept.
Container installs
On Container installs, add-ons don’t exist, but you can run the same software as separate Docker containers. Many people run AdGuard Home, Zigbee2MQTT or a reverse proxy this way.
Safety
Third-party add-ons can have broad access to your system. Install only from repositories you trust, and check the Log tab after you start a new add-on.