Single-board computer with components visible on a desk

Home Assistant Add-ons: 8 to Install First in 2026

Home Assistant add-ons every new install needs in 2026 — File Editor, Mosquitto, ESPHome, Node-RED, Frigate, AdGuard Home, and what to skip.

Home Assistant comes with a vast catalogue of integrations out of the box, but add-ons are where it really starts to feel like a home server. They're not the same thing as integrations — add-ons are full Docker containers running alongside Home Assistant, providing services that the core install can't (or shouldn't) do itself. The Home Assistant supervised install on Raspberry Pi, Home Assistant Yellow, Home Assistant Green, and most x86 mini-PC setups all have access to the official add-on store; Home Assistant Container (the bare-Docker install) does not.

This guide walks through the eight add-ons that benefit almost every new install, what each one does, and the install order that minimises friction. Pair with our [Home Assistant Raspberry Pi setup guide](/blog/home-assistant-raspberry-pi-setup/) for the initial install, and our [Home Assistant automations for beginners](/blog/home-assistant-automations-for-beginners/) for what to do with these add-ons once they're running. Last reviewed: 11 May 2026.

Add-ons vs integrations vs HACS

Knowing the difference before installing anything

Home Assistant's extension ecosystem has three distinct layers, and beginners conflate them constantly. Knowing which is which prevents 80% of 'why doesn't this work' questions.

The three extension layers

Specification Value
Integrations (built-in) Code shipped with Home Assistant Core — connects to devices and services. Configured via Settings → Devices & Services.
Add-ons (Docker containers) Separate services running alongside Home Assistant — File Editor, MQTT broker, etc. Available only on Supervised / OS installs via Settings → Add-ons.
HACS (Home Assistant Community Store) Third-party custom integrations and frontend cards. Installs into the integration layer. Requires separate setup.
Where to install add-ons Settings → Add-ons → Add-on Store. Official repositories included; community repositories addable.

1. File Editor — the first install

Browser-based YAML editing without leaving Home Assistant

File Editor is the simplest possible YAML editor that runs as an add-on, accessible from Home Assistant's sidebar after install. It opens your config directory directly — configuration.yaml, automations.yaml, scripts.yaml, the lot — with syntax highlighting and a save button. You can edit and save without ever opening a terminal or SSH session.

For most beginners, this is the single most useful add-on. The bulk of Home Assistant configuration in 2026 happens through the UI, but edge-case integrations and custom YAML snippets still require direct config file edits. File Editor turns that from a multi-step SSH operation into a sidebar click.

What it does

Web-based YAML editor with syntax highlighting, accessible from Home Assistant's sidebar.

Why install it first

Many integration troubleshooting steps require config file edits. SSH alternatives exist but require terminal comfort.

Install path

Settings → Add-ons → Add-on Store → File Editor → Install → Start → enable 'Show in sidebar' toggle.

Alternative for power users

Studio Code Server gives you VS Code in the browser with full IntelliSense, Git integration, and multi-file editing. Heavier but better for serious YAML work — install it instead of File Editor if you're comfortable with VS Code.

2. Terminal & SSH — for the harder problems

Web-based shell access when the UI isn't enough

The official Terminal & SSH add-on gives you a web-based shell that opens directly into the Home Assistant Operating System's container environment. You don't need to set up SSH keys, port forwarding, or anything else — it just opens a terminal in the browser.

You'll need this less often than File Editor, but when you need it you really need it. Examples: clearing stuck log files, manually pulling a custom integration update, running a one-off backup, or restoring from snapshot when the UI is unreachable.

What it does

Browser-accessible terminal session into the Home Assistant OS container. Includes the ha CLI for system management.

Why install it second

Even if you never touch it, having it pre-installed means you can troubleshoot when something breaks. Faster than setting up SSH later under pressure.

Install path

Settings → Add-ons → Add-on Store → Terminal & SSH → Install → set a password in configuration → Start.

Set a strong password

Terminal & SSH gives shell access to the host. Use a long random password. The Home Assistant Yellow / Green / OS install runs network-isolated by default, but the password is your last line of defence.

3. Samba Share — file access and easy backup

Network-share your Home Assistant config directory

Samba Share exposes the Home Assistant config directory as a network share that mounts on Mac, Windows, and Linux clients. The practical implication: you can edit YAML in your usual desktop editor (VS Code, Sublime, whatever), drop in custom themes and dashboards via drag-and-drop, and access backup snapshots without going through the Home Assistant UI download flow.

It's not strictly necessary if you're happy editing in File Editor or Studio Code Server, but most experienced users end up using Samba for one specific job: pulling backup snapshots to a desktop or NAS as part of a 3-2-1 backup strategy.

4. Mosquitto MQTT — the broker many integrations need

Required for Zigbee2MQTT, ESPHome, Theengs, and many DIY devices

MQTT (Message Queue Telemetry Transport) is the lightweight messaging protocol that a lot of smart-home devices use to talk to each other. Home Assistant doesn't bundle an MQTT broker by default — it expects you to provide one. Mosquitto is the official Home Assistant MQTT broker add-on; install it and you can integrate any MQTT-compatible device or service.

You might not need Mosquitto on day one. But the moment you want to add ESPHome devices, Zigbee2MQTT (instead of the built-in ZHA Zigbee integration), Theengs Gateway for Bluetooth sensors, or any custom Wi-Fi sensors with MQTT firmware, you'll need a broker. Installing Mosquitto early is just less friction later.

What it does

Runs an MQTT broker that other devices and integrations connect to. Acts as the central message bus for IoT communication.

Configuration after install

Settings → Add-ons → Mosquitto broker → Configuration → create a Home Assistant user (Settings → People → Users → Add User, mark 'Local only'). Mosquitto uses Home Assistant user credentials for authentication.

Test it's working

After install, go to Settings → Devices & Services → Add Integration → MQTT. Home Assistant should auto-discover the broker and connect.

Common gotcha

Make sure the MQTT user has 'Local only' enabled and uses a password that doesn't contain '$' or other shell-special characters — escaping inconsistencies between integrations cause hard-to-debug auth failures.

5. ESPHome — the DIY-sensor superpower

Flash ESP32/ESP8266 devices without writing code

ESPHome is the single most transformative add-on on this list for anyone interested in cheap DIY sensors. It runs as a web service inside Home Assistant that lets you build firmware images for ESP32 and ESP8266 microcontrollers — environmental sensors, motion detectors, smart switches, energy monitors — by writing YAML configuration rather than C++ code.

The workflow: connect a $4 ESP32 board via USB or use a pre-flashed device's ESPHome-compatible firmware, define what sensors and outputs it should expose in a short YAML file, click Install, ESPHome compiles and uploads the firmware. The device appears in Home Assistant within minutes with proper entity types, automations, and dashboards.

What it does

Builds custom firmware for ESP32/ESP8266 microcontrollers from a YAML config. Devices auto-discover in Home Assistant.

Hardware to start with

ESP32 NodeMCU dev boards (£4–£8 each on AliExpress / Amazon UK). M5Stack ATOM Lite (£10) for compact sensor nodes. Athom or Shelly devices ship with ESPHome support built-in.

First project for new users

Temperature + humidity sensor in a back room. ~£8 of parts (ESP32 + DHT22), 30 minutes from box to working sensor in Home Assistant. Materially cheaper than commercial Wi-Fi sensors and full control over reporting frequency.

Requires Mosquitto

Strictly, ESPHome uses its own native API now, but many users still configure MQTT as a fallback for visibility. Install Mosquitto first.

6. Node-RED — visual automation flows

An alternative to Home Assistant's built-in automation editor

Home Assistant's built-in Automations editor handles simple if-then-else logic well. Once your automations involve multiple triggers, time-of-day conditions, occupancy detection, weather-aware logic, and queued state machines, the built-in editor starts to feel restrictive. Node-RED is a visual flow-based programming environment that integrates with Home Assistant via the official add-on, offering a much richer automation toolkit.

Whether you actually need Node-RED depends on your appetite for complex automations. Most casual users are happy with the built-in editor for the first six months; serious smart-home builders end up in Node-RED for at least their complex flows. Install when you hit your first 'this is too clunky' moment in the built-in editor, not before — Node-RED has its own learning curve and adds a layer of complexity to your automation debugging.

7. AdGuard Home — network-wide ad blocking

Pi-hole's actively-maintained alternative on Home Assistant

AdGuard Home runs a DNS-level ad blocker that intercepts ad and tracker domains for every device on your network — phones, smart TVs, IoT devices, computers. It's the same idea as [Pi-hole](/blog/what-is-pi-hole-smart-home/) (which we've covered separately), but available as a one-click Home Assistant add-on and arguably better-maintained at the moment.

The setup is two steps: install the AdGuard Home add-on and configure your router to point all DNS queries to your Home Assistant box. From then on, every ad and tracker hostname is blocked at the network level — visible on every device including those you can't install an ad blocker on (smart TVs, set-top boxes, kids' tablets, friends' phones).

Setup time

30 minutes for the add-on install + DNS routing config. The router-side change is the part that confuses beginners — point the router's primary DNS server to your Home Assistant IP address.

Performance impact

Negligible on Raspberry Pi 4 / 5 — DNS query handling is light. Lighter than Pi-hole's standalone install because it's sharing the Home Assistant host.

When NOT to install

If you already run Pi-hole on a separate device, don't dual-stack. Pick one. If your home network is router-managed by your ISP and DNS forwarding is locked, AdGuard Home works only on devices you point manually.

8. Frigate — AI-powered camera NVR

Local object detection for security cameras

Frigate is the most demanding add-on on this list — it does real-time AI object detection on camera feeds and stores recordings locally without sending anything to a cloud service. Think 'doorbell-camera AI' but on your own hardware: tell Frigate to notify you when a person walks up the driveway, a package is delivered, or a vehicle appears, without paying Ring or Nest a monthly subscription.

The catch is hardware. Frigate needs a Coral USB AI accelerator (~£60) for reliable real-time detection on more than 1–2 camera streams. A Raspberry Pi 4 alone struggles past two streams; Pi 5 handles more but is still constrained. Install Frigate later in your Home Assistant journey, once you have cameras and the Coral hardware to run them properly.

Add-ons NOT to install on day one

Some popular ones add complexity without immediate value

Duck DNS + Let's Encrypt (only when needed)

These let you access Home Assistant over the internet with HTTPS. Useful but adds remote-access risk before you've hardened the rest of the setup. Add only after your local instance is working and you have a specific reason to need remote access.

MariaDB (only for high-volume sensor logging)

Replaces Home Assistant's default SQLite database. Worth it for installs with 50+ sensors logging every few seconds. For typical home use, SQLite is fine and MariaDB is an unnecessary complication.

InfluxDB + Grafana (only if you want long-term dashboards)

Excellent for sensor-history graphs over months/years. Niche need. Skip unless you've decided you want dedicated time-series dashboards.

AppDaemon / pyscript (Python automation alternatives)

Python-based automation environments. Powerful but overkill if Node-RED already covers your visual-flow needs.

Whisper / Piper (local voice assistant)

Local-only voice replacement for Alexa / Google Assistant. Cool but very hardware-dependent (needs a microphone hub and meaningful compute). Phase 3 add-on, not day 1.

The install pattern that works

How to actually add these without breaking your setup

1
Take a full snapshot first

Settings → System → Backups → Create Backup. If anything goes wrong, you can restore in 10 minutes. The cheapest insurance in home automation.

2
Install one add-on at a time

Install. Start. Check the logs show 'Started successfully'. Use it for a day. Then move to the next. Batch-installing four add-ons at once and having one fail makes debugging much harder.

3
Read the documentation tab on each add-on

Most add-ons have a Documentation tab in the add-on view. It's faster to read than to discover via trial-and-error.

4
Enable 'Show in sidebar' selectively

Add-ons with management UIs (File Editor, Node-RED, ESPHome) should be visible from the sidebar. Background-service add-ons (Mosquitto, Samba) shouldn't be — they clutter the sidebar without offering anything clickable.

5
Keep Auto Update OFF initially

Some add-on updates break integrations. Manually update one at a time after you understand which add-ons you can't afford to break.

Frequently asked questions

Do I need to install all 8 add-ons?
No. The minimum useful set is File Editor (or Studio Code Server) plus Terminal & SSH for general management. Beyond that, install Mosquitto if you'll use MQTT devices, ESPHome if you want DIY sensors, Node-RED if your automations get complex, AdGuard Home for network ad-blocking. Frigate only if you have cameras and the Coral accelerator hardware.
What's the difference between an add-on and an integration?
Add-ons are separate Docker containers running alongside Home Assistant — they provide services (an MQTT broker, an ad blocker, a file editor). Integrations are Home Assistant code that connects to devices and services (a Hue bulb, a Spotify account). You configure integrations under Settings → Devices & Services; add-ons under Settings → Add-ons.
I can't see the Add-ons menu in Settings — what's wrong?
You're probably running Home Assistant Container instead of Home Assistant OS / Supervised. Container installs don't have add-ons — the equivalent functionality requires running each service as a separate Docker container on your host. For most home users, switching to a Home Assistant OS install (on a Raspberry Pi, Yellow, or mini-PC) is the right answer; for Docker power users, sticking with Container is fine.
Does installing more add-ons slow Home Assistant down?
Slightly. Each add-on is a running Docker container consuming RAM and CPU. A Raspberry Pi 4 (4GB) handles 5–6 add-ons including ESPHome and Mosquitto comfortably; adding Frigate without a Coral accelerator pushes it past comfortable. Pi 5 with 8GB RAM handles the full set above without issue.
Where does add-on data live? Will I lose it on update?
Add-on data persists in the Home Assistant data volume. Add-on updates preserve your configuration unless the upstream maintainer has changed the config schema (rare). Full system backups (Settings → System → Backups) include add-on data — restoring a backup restores add-ons too.
What's HACS and is it an add-on?
HACS (Home Assistant Community Store) is NOT an add-on — it's a custom integration that, once installed, lets you browse and install community-maintained integrations and frontend cards. It plugs into the integration layer, not the add-on layer. Install HACS only after you have a specific community integration in mind; otherwise it adds complexity without immediate value.
Should I install Pi-hole or AdGuard Home?
AdGuard Home is easier on Home Assistant because it runs as a one-click add-on; Pi-hole requires a separate install on a separate device (or in its own Docker container). Functionally they're similar — both block DNS-level ads and trackers across your whole network. Pick AdGuard Home if you're consolidating onto Home Assistant; pick Pi-hole if you already run it elsewhere and want to keep it. Don't run both — only one DNS resolver should be active on the network.
Can I run Home Assistant add-ons on a NAS instead of Pi?
Yes — Home Assistant OS runs on Synology and QNAP NAS units via virtualisation (Virtual Machine Manager on Synology, Virtualization Station on QNAP). Performance is usually better than Raspberry Pi 4, and you benefit from the NAS's existing backup and RAID setup. Synology DS920+ / DS923+ class units are popular Home Assistant hosts.

Related guides


Sources: Home Assistant official documentation (current at 11 May 2026); Home Assistant Add-on Store official repositories; ESPHome project documentation; Mosquitto MQTT broker documentation; Node-RED Home Assistant nodes documentation; Frigate documentation; AdGuard Home Home Assistant integration documentation. This is an editorial DIY guide based on the official Home Assistant ecosystem. Add-ons, repositories, and integration details can change with each Home Assistant release — always check the current Home Assistant documentation before installing.