Erster Start

## 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.local nicht 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.

1. 1. Account
2. 2. Zuhause
3. 3. Standort
4. 4. Geräte
5. 5. 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:

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 Masseinheiten

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"
4latitude: 52.5200
5longitude: 13.4050
6radius: 200               # Radius in Metern
7icon: mdi:briefcase
8
9  - name: "Fitnessstudio"
10latitude: 52.5100
11longitude: 13.3900
12radius: 100
13icon: mdi:weight-lifter
14
15  - name: "Schule"
16latitude: 52.5150
17longitude: 13.4100
18radius: 150
19icon: mdi:school

1# Automation: Anwesenheitsbasiert
2automation:
3  - alias: "Willkommen zuhause"
4trigger:
5  - platform: zone
6    entity_id: person.max
7    zone: zone.home
8    event: enter
9condition:
10  - condition: sun
11    after: sunset
12action:
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: 21

Schritt 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

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

1. Geräte hinzufügen — Füge weitere Smart-Home-Geräte über Integrationen hinzu
2. Räume erstellen — Organisiere Geräte in Räumen: Wohnzimmer, Schlafzimmer, Küche
3. Dashboard anpassen — Entferne unnötige Karten, erstelle eigene Ansichten
4. Erste Automation — Erstelle deine erste einfache Automation (z.B. Licht bei Sonnenuntergang)
5. Companion App installieren — Installiere die HA App auf deinem Smartphone für Fernzugriff und Push
6. Backup einrichten — Erstelle ein erstes Backup unter Einstellungen, System, Sicherungen

Erweiterten Modus aktivieren

Standardmäßig blendet Home Assistant einige Optionen aus, um Anfänger nicht zu überfordern. Der erweiterte Modus schaltet zusätzliche Funktionen frei:

• 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

Hinweis: Gehe zu Profil (unten links), scrolle nach unten und aktiviere Erweiterter Modus. Die Änderung ist sofort wirksam und kann jederzeit deaktiviert werden.

Die Entwicklerwerkzeuge

Die Entwicklerwerkzeuge sind dein wichtigstes Debugging- und Test-Tool. Du findest sie in der Sidebar:

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 weiss, 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

1. App installieren — Im App Store (iOS) oder Play Store (Android) nach Home Assistant suchen
2. Server verbinden — Die App findet deinen HA-Server automatisch im lokalen Netzwerk
3. Anmelden — Mit deinem HA-Benutzerkonto einloggen
4. Berechtigungen erteilen — GPS, Benachrichtigungen und Sensoren freigeben
5. 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"
4trigger:
5  - platform: state
6    entity_id: binary_sensor.tuerklingel
7    to: "on"
8action:
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: high

1# Handy-Sensoren in Automationen nutzen
2automation:
3  - alias: "Akku niedrig Warnung"
4trigger:
5  - platform: numeric_state
6    entity_id: sensor.mein_handy_battery_level
7    below: 15
8condition:
9  - condition: state
10    entity_id: person.max
11    state: "home"
12action:
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"
19trigger:
20  - platform: state
21    entity_id: sensor.mein_handy_wifi_connection
22    to: "MeinHeim-WLAN"
23action:
24  - service: input_boolean.turn_on
25    target:
26      entity_id: input_boolean.jemand_zuhause

Häufige Probleme beim Erststart

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 — 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 überwaltigt zu sein — Home Assistant bietet extrem viele Möglichkeiten. Starte einfach mit einem Gerät und baue von dort aus auf.