Home Assistant Add-ons & ESPHome

Was sind Add-ons?

Add-ons sind eigenständige Programme, die direkt auf deinem Home Assistant Server laufen. Sie laufen in eigenen Docker-Containern und erweitern die Funktionalität, ohne dass du einen separaten Server brauchst.

Hinweis: Add-ons sind nur bei Home Assistant OS und Supervised verfügbar. Bei Container- oder Core-Installation musst du diese Dienste selbst als Docker-Container betreiben.

Add-on vs. Integration: Der Unterschied

Add-on Store nutzen

1. Store öffnen: Einstellungen → Add-ons → Add-on Store (Button unten rechts)
2. Add-on suchen: Durchsuche Kategorien oder nutze die Suchleiste
3. Installieren: Klicke auf das Add-on, dann auf Installieren und warte auf den Download
4. Starten: Nach Installation: Starten klicken
5. Konfigurieren: Optional: Beim Booten starten und Watchdog aktivieren

Die 10 wichtigsten Add-ons im Detail

1. File Editor

Code-Editor direkt in der HA-UI. Perfekt für schnelle Änderungen an YAML-Dateien.

2. Terminal & SSH

Kommandozeilen-Zugriff, unverzichtbar für Fehlerbehebung und fortgeschrittene Konfiguration.

Hinweis: Installiere SSH jetzt, nicht erst wenn die Web-UI nicht mehr erreichbar ist. SSH ist oft der einzige Weg, HA im Notfall zu reparieren.

3. Samba Share

Gibt den Konfigurationsordner als Netzwerkfreigabe frei. Dateien vom PC aus bearbeiten.

1# Samba Share Zugriff (Windows)
2# In der Explorer-Adressleiste eingeben:
3# \\\\homeassistant.local\\config
4# 
5# Oder die IP-Adresse:
6# \\\\192.168.1.100\\config
7#
8# Login: Dein HA-Benutzername und Passwort

4. Mosquitto MQTT Broker

MQTT-Broker für IoT-Kommunikation. Benötigt für Zigbee2MQTT, Tasmota und DIY-Projekte. Alles zur Einrichtung findest du im MQTT Guide.

1# MQTT Sensor konfigurieren
2mqtt:
3  sensor:
4    - name: "Außentemperatur"
5      state_topic: "sensor/aussen/temperatur"
6      unit_of_measurement: "°C"
7      device_class: temperature
8      value_template: "{{ value_json.temperature }}"
9
10    - name: "Luftfeuchtigkeit Außen"
11      state_topic: "sensor/aussen/temperatur"
12      unit_of_measurement: "%"
13      device_class: humidity
14      value_template: "{{ value_json.humidity }}"
15
16  binary_sensor:
17    - name: "Bewegung Garten"
18      state_topic: "sensor/garten/pir"
19      device_class: motion
20      payload_on: "1"
21      payload_off: "0"

5. Zigbee2MQTT

Alternative zur ZHA-Integration. Verbindet 3.000+ Zigbee-Geräte über MQTT. Eigene Web-UI für Geräteverwaltung und Firmware-Updates.

Vorteile:

• 3.000+ unterstützte Geräte
• Eigene Web-UI
• OTA-Firmware-Updates
• Mehr Konfigurationsoptionen
• Aktive Community

Nachteile:

• Braucht Mosquitto MQTT zusätzlich
• Komplexerer Setup als ZHA
• Etwas mehr Ressourcenverbrauch

6. Node-RED

Visuelle Programmierung für Automationen. Besonders gut für komplexe Logik mit vielen Verzweigungen und externen APIs.

Vorteile:

• Visueller Flow-Editor
• Extrem flexibel
• Riesige Node-Bibliothek
• HTTP-Requests, APIs, Datenbanken

Nachteile:

• Zusätzliche Komplexität
• Automationen nicht in HA-UI sichtbar
• Eigene Lernkurve

7–10: Weitere wichtige Add-ons

• HACS: Community Store für Integrationen, Cards, Themes. Streng genommen kein Add-on, sondern eine eigene Integration, aber ein Must-Have.
• MariaDB: Ersetzt SQLite für bessere Performance bei 500+ Entities.
• Let's Encrypt: Automatische SSL-Zertifikate für verschlüsselten Zugriff.
• Grafana: Professionelle Dashboards und Diagramme für Langzeit-Daten.
• Frigate: KI-basierte Objekterkennung für Überwachungskameras.
• AdGuard Home: Netzwerkweiter Werbeblocker direkt auf deinem HA-Server.

ESPHome: Eigene Geräte bauen

ESPHome ist ein Framework für ESP32/ESP8266-Mikrocontroller. Du definierst dein Gerät in YAML, ohne C++, und flashst es direkt aus Home Assistant.

1. YAML schreiben
2. Kompilieren
3. Flashen
4. Integration

Was du brauchst

• ESP32 Board: ESP32 DevKit, Wemos D1 Mini oder ESP32-S3 (~5–15 €)
• USB-Kabel: Zum ersten Flashen (danach OTA per WLAN)
• Sensoren: DHT22, BME280, PIR, Relais, je nach Projekt
• ESPHome Add-on: In Home Assistant installieren und starten

Beispiel 1: Temperatur & Luftfeuchtigkeit (DHT22)

1# ESPHome: DHT22 Sensor
2esphome:
3  name: sensor-wohnzimmer
4  friendly_name: "Wohnzimmer Sensor"
5
6esp32:
7  board: esp32dev
8
9wifi:
10  ssid: !secret wifi_ssid
11  password: !secret wifi_password
12
13  # Fallback-Hotspot bei Verbindungsproblemen
14  ap:
15    ssid: "Sensor-WZ Fallback"
16    password: "fallback123"
17
18api:
19  encryption:
20    key: !secret api_key
21
22ota:
23  - platform: esphome
24    password: !secret ota_password
25
26sensor:
27  - platform: dht
28    pin: GPIO4
29    model: DHT22
30    temperature:
31      name: "Temperatur"
32      filters:
33        - offset: -0.5         # Kalibrierung
34    humidity:
35      name: "Luftfeuchtigkeit"
36    update_interval: 30s
37
38  # Signalstärke als Bonus-Sensor
39  - platform: wifi_signal
40    name: "WLAN Signalstärke"
41    update_interval: 60s

Beispiel 2: Smarter Bewegungsmelder mit Status-LED

1# ESPHome: PIR + LED + Lichtsensor
2binary_sensor:
3  - platform: gpio
4    pin: GPIO14
5    name: "Bewegung"
6    device_class: motion
7    filters:
8      - delayed_off: 30s         # 30 Sek. aktiv nach letzter Bewegung
9
10light:
11  - platform: binary
12    name: "Status LED"
13    output: led_output
14
15output:
16  - platform: gpio
17    id: led_output
18    pin: GPIO2
19
20sensor:
21  - platform: adc
22    pin: GPIO34
23    name: "Helligkeit"
24    unit_of_measurement: "lx"
25    update_interval: 10s
26    filters:
27      - lambda: |-
28          return (x * 3.3 / 4095.0) * 500;  // Rohwert -> Lux

Beispiel 3: Garagentor-Steuerung

1# ESPHome: Garagentor mit Reedkontakt
2cover:
3  - platform: template
4    name: "Garagentor"
5    device_class: garage
6    open_action:
7      - switch.turn_on: relay
8      - delay: 500ms
9      - switch.turn_off: relay
10    close_action:
11      - switch.turn_on: relay
12      - delay: 500ms
13      - switch.turn_off: relay
14    lambda: |-
15      if (id(reed_contact).state) {
16        return COVER_OPEN;
17      } else {
18        return COVER_CLOSED;
19      }
20
21switch:
22  - platform: gpio
23    id: relay
24    pin: GPIO5
25    restore_mode: ALWAYS_OFF
26
27binary_sensor:
28  - platform: gpio
29    id: reed_contact
30    pin:
31      number: GPIO14
32      mode: INPUT_PULLUP
33    name: "Garagentor Status"
34    device_class: garage_door

Beispiel 4: Pflanzensensor (Bodenfeuchtigkeit)

1# ESPHome: Kapazitiver Bodensensor
2sensor:
3  - platform: adc
4    pin: GPIO34
5    name: "Bodenfeuchte Tomate"
6    unit_of_measurement: "%"
7    update_interval: 60s
8    attenuation: 11db
9    filters:
10      - calibrate_linear:
11          - 2.8 -> 0.0            # Trockener Sensor = 0%
12          - 1.2 -> 100.0          # In Wasser = 100%
13      - clamp:
14          min_value: 0
15          max_value: 100
16
17  - platform: dht
18    pin: GPIO4
19    model: DHT22
20    temperature:
21      name: "Gewächshaus Temperatur"
22    humidity:
23      name: "Gewächshaus Luftfeuchte"
24    update_interval: 30s

Beispiel 5: LED-Strip Controller (WS2812B)

1# ESPHome: Adressierbare LEDs
2light:
3  - platform: neopixelbus
4    type: GRB
5    variant: WS2812
6    pin: GPIO5
7    num_leds: 60
8    name: "LED Strip Wohnzimmer"
9    effects:
10      - addressable_rainbow:
11          name: "Regenbogen"
12          speed: 30
13      - addressable_color_wipe:
14          name: "Farbwische"
15      - addressable_scan:
16          name: "Scanner"
17      - addressable_fireworks:
18          name: "Feuerwerk"

ESPHome vs. Tasmota vs. WLED

Hinweis: Beliebte Projekte: Pflanzenbewässerung, Garagentoröffner, Briefkastensensor, Luftqualitätsmesser (CO2), BLE-Anwesenheitserkennung, Futterspender für Haustiere, Pool-Temperatursensor.

Häufige Fragen

Was ist der Unterschied zwischen Add-on und Integration?

Ein Add-on ist ein eigenständiger Dienst, der in einem eigenen Docker-Container auf deinem Server läuft, zum Beispiel der File Editor oder Node-RED. Eine Integration ist ein Plugin innerhalb von Home Assistant, das ein Gerät oder einen Dienst anbindet, etwa Shelly oder Hue.

Warum sehe ich keinen Add-on Store?

Add-ons gibt es nur bei Home Assistant OS und Supervised. Wenn du Home Assistant als Container oder Core installiert hast, fehlt der Add-on Store und du musst Dienste wie Mosquitto oder Node-RED selbst als Docker-Container betreiben.

Welche Add-ons sollte ich zuerst installieren?

File Editor für schnelle YAML-Änderungen, Terminal & SSH für den Notfall-Zugriff und Samba Share, um Dateien vom PC aus zu bearbeiten. Installiere SSH am besten sofort, nicht erst wenn die Web-UI nicht mehr erreichbar ist. Für Zigbee2MQTT und Tasmota kommt der Mosquitto MQTT-Broker dazu.

Was ist ESPHome?

ESPHome ist ein Framework, mit dem du eigene Geräte auf Basis von ESP32- oder ESP8266-Mikrocontrollern baust. Du beschreibst Sensoren, Schalter und Logik in YAML und flashst die Firmware direkt aus Home Assistant. Beliebte Projekte sind Temperatursensoren, Garagentor-Steuerungen und Pflanzensensoren.

Brauche ich Programmierkenntnisse für ESPHome?

Nein, C++ ist nicht nötig. Die komplette Konfiguration läuft über YAML, und nach dem ersten Flashen per USB-Kabel kommen Updates drahtlos per OTA. Ein ESP32-Board kostet 5 bis 15 Euro, dazu ein Sensor wie der DHT22 und das ESPHome Add-on, mehr brauchst du für den Start nicht.

Weiter lesen:

• Integrationen einrichten
• MQTT in Home Assistant
• Home Assistant installieren