Home Assistant: Erster Start
Home Assistant nach der Installation einrichten: Onboarding-Prozess Schritt für Schritt mit Benutzerkonto, Companion App und ersten Einstellungen.
Der Onboarding-Assistent
Wenn du Home Assistant zum ersten Mal öffnest (unter http://homeassistant.local:8123),
begrüßt dich der Einrichtungsassistent. Er führt dich in wenigen Schritten durch die Grundkonfiguration.
Der gesamte Prozess dauert nur wenige Minuten und kann jederzeit später angepasst werden.
Hinweis: Falls
homeassistant.localnicht funktioniert, versuche die IP-Adresse deines Geräts direkt im Browser (z.B.http://192.168.1.100:8123). Die IP findest du in der Geräteliste deines Routers.
-
- Account
-
- Zuhause
-
- Standort
-
- Geräte
-
- Fertig!
Schritt 1: Benutzerkonto erstellen
Du erstellst den Owner-Account, den Hauptbenutzer mit vollen Admin-Rechten. Dieses Konto hat Zugriff auf alle Einstellungen, Add-ons und Konfigurationen.
Das Formular fragt nach:
- Name: Dein Anzeigename (z.B. Max)
- Benutzername: Für den Login (z.B. max)
- Passwort: Mindestens 8 Zeichen, besser 12+
Hinweis: Wähle ein starkes Passwort! Dieses Konto hat vollen Zugriff auf dein Smart Home, einschließlich Kameras, Türschlösser und mehr. Nutze einen Passwort-Manager und aktiviere später 2FA unter Profil, Sicherheit.
Hinweis: Dieses Konto ist rein lokal. Es wird kein Cloud-Account erstellt, keine E-Mail-Verifizierung benötigt. Deine Daten bleiben auf deinem Gerät.
Weitere Benutzer später anlegen
Nach dem Onboarding kannst du weitere Benutzer erstellen für Familienmitglieder oder Gäste. Jeder Benutzer bekommt eigene Zugangsdaten und kann unterschiedliche Berechtigungen haben:
| Benutzertyp | Rechte | Verwendung |
|---|---|---|
| Administrator | Voller Zugriff auf alles | Du (Hauptbenutzer) |
| Benutzer | Dashboard und Geräte steuern | Partner, Familie |
| Lokaler Benutzer | Nur im Heimnetzwerk | Gäste, Kinder |
Schritt 2: Zuhause benennen
Gib deinem Zuhause einen Namen (z.B. Wohnung Berlin oder Haus am See). Dieser Name erscheint:
- Im Dashboard-Header als Titel
- In der Companion App auf dem Handy
- Bei Multi-Standort-Setups zur Unterscheidung
- In Benachrichtigungen als Absender
Du kannst den Namen jederzeit unter Einstellungen, Allgemein ändern.
Schritt 3: Standort festlegen
Setze deinen Standort auf der Karte. Dies ist wichtig, da Home Assistant den Standort für viele Funktionen nutzt:
- Sonnenauf-/untergang: Berechnung für Licht-Automationen basierend auf astronomischen Daten
- Wetterdaten: Lokale Wettervorhersage mit Temperatur, Wind, Niederschlag
- Zeitzone: Korrekte Uhrzeit für alle zeitgesteuerten Automationen
- Anwesenheit: Home/Away-Zonen für Anwesenheitserkennung über GPS
- Höhenmeter: Genauere Wetter- und Luftdruckdaten durch Höhenangabe
- Lokalisierung: Spracheinstellungen und Maßeinheiten
Hinweis: Home Assistant fragt auch nach deinem bevorzugten Einheiten-System. In Deutschland wähle Metrisch für Grad Celsius, km, kg. Du kannst einzelne Einheiten später pro Entity überschreiben.
Standort-Zonen konfigurieren
Neben dem Hauptstandort kannst du weitere Zonen definieren (Arbeitsplatz, Schule, Fitnessstudio). Zonen werden für GPS-basierte Automationen genutzt:
1# Zonen in configuration.yaml
2zone:
3 - name: "Arbeit"
4 latitude: 52.5200
5 longitude: 13.4050
6 radius: 200 # Radius in Metern
7 icon: mdi:briefcase
8
9 - name: "Fitnessstudio"
10 latitude: 52.5100
11 longitude: 13.3900
12 radius: 100
13 icon: mdi:weight-lifter
14
15 - name: "Schule"
16 latitude: 52.5150
17 longitude: 13.4100
18 radius: 150
19 icon: mdi:school1# Automation: Anwesenheitsbasiert
2automation:
3 - alias: "Willkommen zuhause"
4 trigger:
5 - platform: zone
6 entity_id: person.max
7 zone: zone.home
8 event: enter
9 condition:
10 - condition: sun
11 after: sunset
12 action:
13 - service: light.turn_on
14 target:
15 area_id: flur
16 data:
17 brightness_pct: 80
18 - service: climate.set_temperature
19 target:
20 entity_id: climate.wohnzimmer
21 data:
22 temperature: 21Schritt 4: Geräte automatisch erkennen
Home Assistant scannt dein lokales Netzwerk und zeigt bereits erkannte Geräte an. Die Erkennung nutzt verschiedene Protokolle wie mDNS, SSDP und UPnP.
Erkennungs-Protokolle
| Protokoll | Erkennt | Beispiele |
|---|---|---|
| mDNS/Zeroconf | Geräte die sich im Netzwerk ankündigen | Shelly, ESPHome, Chromecast |
| SSDP/UPnP | Universal Plug and Play Geräte | Hue Bridge, Sonos, Smart TVs |
| DHCP | Neue Geräte die eine IP bekommen | Alles mit Netzwerkverbindung |
| Bluetooth | BLE-Geräte in der Nähe | Switchbot, Xiaomi Sensoren |
| USB | Angeschlossene USB-Geräte | Zigbee/Z-Wave Sticks, ConBee |
Typische automatisch erkannte Geräte:
- Philips Hue Bridge: Lampen, Sensoren, Schalter über die Hue Bridge
- Sonos Lautsprecher: Multiroom-Audio, Gruppierung, TTS
- Chromecast / Google TV: Mediensteuerung, Casting, Statusanzeige
- Netzwerkdrucker: Tintenstand, Druckaufträge, Status
- FRITZ!Box: Anwesenheit, Smart Home, Anrufe
- Shelly Geräte: Steckdosen, Relais, Sensoren über WLAN
- Smart TVs: Samsung, LG, Sony. Ein/Aus, Lautstärke, Apps
- Spotify Connect: Musiksteuerung, aktuelle Wiedergabe
Hinweis: Zigbee- und Z-Wave-Geräte benötigen einen USB-Stick und eine separate Integration. Bluetooth-Geräte brauchen einen BLE-Adapter. Diese Geräte kannst du nach dem Onboarding einzeln hinzufügen.
Schritt 5: Fertig!
Nach dem Onboarding landest du auf deinem Dashboard. Das automatisch erstellte Dashboard zeigt bereits alle erkannten Geräte, gruppiert nach Bereich.
Was du jetzt tun solltest
- Geräte hinzufügen: Füge weitere Smart-Home-Geräte über Integrationen hinzu
- Räume erstellen: Organisiere Geräte in Räumen: Wohnzimmer, Schlafzimmer, Küche
- Dashboard anpassen: Entferne unnötige Karten, erstelle eigene Ansichten
- Erste Automation: Erstelle deine erste einfache Automation (z.B. Licht bei Sonnenuntergang)
- Companion App installieren: Installiere die HA App auf deinem Smartphone für Fernzugriff und Push
- Backup einrichten: Erstelle ein erstes Backup unter Einstellungen, System, Sicherungen
Alle Funktionen sofort verfügbar
Seit Home Assistant 2026.6 sind alle Funktionen standardmäßig sichtbar. Den früheren "Erweiterten Modus" gibt es nicht mehr. Du hast von Anfang an Zugriff auf:
- YAML-Editor für Automationen und Scripts
- Template-Editor in den Entwicklerwerkzeugen
- Erweiterte Entity-Einstellungen
- Add-on-Konfiguration über YAML
- Supervisor-Zugriff auf System-Einstellungen
Die Entwicklerwerkzeuge
Die Entwicklerwerkzeuge sind dein wichtigstes Debugging- und Test-Tool. Du findest sie in der Sidebar:
| Tab | Funktion | Wofür? |
|---|---|---|
| Zustände | Alle Entity-Zustände anzeigen/ändern | Werte prüfen, manuell setzen |
| Aktionen | Aktionen (Services) manuell aufrufen | Licht einschalten, Notifications testen |
| Template | Jinja2-Templates live testen | Berechnungen und Logik prüfen |
| Ereignisse | Events abhören und senden | Debugging von Automationen |
| Statistik | Langzeit-Statistiken verwalten | Fehlerhafte Energiedaten korrigieren |
1# Template-Editor Beispiele
2{# Aktuelle Temperatur formatiert #}
3Temperatur: {{ states('sensor.wohnzimmer_temperatur') }}°C
4
5{# Anzahl eingeschalteter Lichter #}
6{{ states.light | selectattr('state', 'eq', 'on') | list | count }} Lichter an
7
8{# Zeit seit letzter Bewegung #}
9{{ relative_time(states.binary_sensor.flur_bewegung.last_changed) }}
10
11{# Personalisierte Begrüßung #}
12{% set hour = now().hour %}
13{% if hour < 12 %}Guten Morgen{% elif hour < 18 %}Guten Tag{% else %}Guten Abend{% endif %}, {{ user }}!Die Companion App
Die Home Assistant Companion App (kostenlos für iOS und Android) erweitert dein System um wichtige mobile Funktionen:
- GPS-Tracking: Anwesenheitserkennung: HA weiß, ob du zuhause oder unterwegs bist
- Push-Benachrichtigungen: Alarme, Warnungen und Statusmeldungen direkt aufs Handy
- Handy-Sensoren: Akku, WLAN, Bluetooth, Schritte, als Entities in HA
- Widgets & Quick Actions: Geräte direkt vom Homescreen steuern ohne die App zu öffnen
- Kamera-Zugriff: Handy-Kamera als Überwachungskamera nutzen
- TTS-Ausgabe: Sprachnachrichten auf dem Handy abspielen
Companion App einrichten
- App installieren: Im App Store (iOS) oder Play Store (Android) nach Home Assistant suchen
- Server verbinden: Die App findet deinen HA-Server automatisch im lokalen Netzwerk
- Anmelden: Mit deinem HA-Benutzerkonto einloggen
- Berechtigungen erteilen: GPS, Benachrichtigungen und Sensoren freigeben
- Widgets hinzufügen: Auf dem Homescreen: Widget hinzufügen und Geräte wählen
1# Push-Benachrichtigung mit Bild (Automation)
2automation:
3 - alias: "Türklingel Foto senden"
4 trigger:
5 - platform: state
6 entity_id: binary_sensor.tuerklingel
7 to: "on"
8 action:
9 - service: notify.mobile_app_mein_handy
10 data:
11 title: "Jemand klingelt!"
12 message: "Schau wer vor der Tür steht."
13 data:
14 image: /api/camera_proxy/camera.haustuer
15 actions:
16 - action: OPEN_DOOR
17 title: "Tür öffnen"
18 - action: IGNORE
19 title: "Ignorieren"
20 tag: doorbell
21 channel: doorbell
22 importance: high1# Handy-Sensoren in Automationen nutzen
2automation:
3 - alias: "Akku niedrig Warnung"
4 trigger:
5 - platform: numeric_state
6 entity_id: sensor.mein_handy_battery_level
7 below: 15
8 condition:
9 - condition: state
10 entity_id: person.max
11 state: "home"
12 action:
13 - service: notify.mobile_app_mein_handy
14 data:
15 title: "Akku niedrig!"
16 message: "Dein Akku ist bei {{ states('sensor.mein_handy_battery_level') }}%. Lade dein Handy."
17
18 - alias: "WLAN-basierte Anwesenheit"
19 trigger:
20 - platform: state
21 entity_id: sensor.mein_handy_wifi_connection
22 to: "MeinHeim-WLAN"
23 action:
24 - service: input_boolean.turn_on
25 target:
26 entity_id: input_boolean.jemand_zuhauseHäufige Probleme beim Erststart
| Problem | Ursache | Lösung |
|---|---|---|
| homeassistant.local nicht erreichbar | mDNS nicht unterstützt | IP-Adresse direkt im Browser nutzen |
| Seite lädt, aber zeigt Fehler | Ersteinrichtung läuft noch | Bis zu 20 Min. warten, Seite neu laden |
| Keine Geräte erkannt | Unterschiedliche Subnetze | AP-Isolation im Router deaktivieren |
| Preparing HA bleibt hängen | Langsames Internet | Bis 30 Min. warten, Ethernet statt WLAN |
| SSL-Warnung im Browser | Selbstsigniertes Zertifikat | Normal bei lokaler Installation, Ausnahme hinzufügen |
| Dashboard ist leer | Auto-Dashboard nicht aktiviert | Übersicht, drei Punkte, automatisches Dashboard aktivieren |
Hinweis: Nach der Installation braucht Home Assistant bis zu 20 Minuten für die Ersteinrichtung. Warte ab und lade die Seite neu. Du siehst eine Preparing Home Assistant-Meldung.
Nächste Schritte
- Erstes Gerät hinzufügen: Am Beispiel eines Shelly Plug, Schritt-für-Schritt-Anleitung
- Dashboard verstehen: Karten, Tabs, Räume und alles über die Benutzeroberfläche
- Automationen erstellen: Deine erste Wenn-Dann-Regel für intelligentes Verhalten
- YAML verstehen: Die Konfigurationssprache von Home Assistant lernen
- Backup einrichten: Sichere dein System regelmäßig, bevor etwas schiefgeht
- Fernzugriff einrichten: Von unterwegs sicher auf dein Smart Home zugreifen
Tipp: Nimm dir Zeit für die ersten Schritte. Es ist normal, anfangs etwas überwältigt zu sein. Home Assistant bietet extrem viele Möglichkeiten. Starte einfach mit einem Gerät und baue von dort aus auf.
Häufige Fragen
Wie öffne ich Home Assistant zum ersten Mal?
Ruf im Browser http://homeassistant.local:8123 auf. Dort startet der Onboarding-Assistent, der dich durch Benutzerkonto, Standort und Geräteerkennung führt. Der ganze Prozess dauert nur wenige Minuten und lässt sich später jederzeit anpassen.
Warum ist homeassistant.local nicht erreichbar?
Meist unterstützt dein Netzwerk kein mDNS. Gib dann die IP-Adresse des Geräts direkt im Browser ein, etwa http://192.168.1.100:8123. Die IP findest du in der Geräteliste deines Routers.
Wie lange dauert die Ersteinrichtung von Home Assistant?
Nach der Installation braucht Home Assistant bis zu 20 Minuten, solange siehst du eine Preparing-Meldung. Warte ab und lade die Seite neu. Das Onboarding selbst ist danach in wenigen Minuten erledigt.
Brauche ich ein Cloud-Konto für Home Assistant?
Nein. Der Owner-Account beim Onboarding ist rein lokal, ohne E-Mail-Verifizierung, und deine Daten bleiben auf deinem Gerät. Wähle trotzdem ein starkes Passwort, denn das Konto hat vollen Zugriff auf dein Smart Home.
Wie richte ich die Companion App ein?
Installiere die kostenlose Home Assistant App aus dem App Store oder Play Store. Sie findet deinen Server automatisch im lokalen Netzwerk, danach meldest du dich mit deinem HA-Benutzerkonto an und gibst GPS und Benachrichtigungen frei. Damit bekommst du Push-Nachrichten und Anwesenheitserkennung aufs Handy.
Weiter lesen:
