HACS and Customization

What Are Home Assistant Add-ons and How Do You Install Them?

Add-ons are extra apps that run beside Home Assistant on Home Assistant OS. Learn what they do, how to install one, and how they differ from integrations.

On this page
  1. Add-ons, integrations and HACS
  2. Which install types have add-ons
  3. Popular add-ons
  4. How to install an add-on
  5. Add a third-party repository
  6. After you install
  7. Container installs
  8. Safety

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.

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:

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

  1. Go to Settings > Apps and open the App store (older releases call this the Add-on Store).
  2. Select an add-on, then select Install.
  3. Open the Configuration tab and set any required options. You can enter them as YAML or in the form.
  4. Turn on Start on boot, Watchdog or Show in sidebar if you want them.
  5. 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.

The complete guide to hacs and customization

What Is HACS and How to Install It in Home Assistant
Read the guide

Keep exploring

Guides from other topics

All topics →