Home Assistant WLAN einrichten – so verbindest du HA OS per WLAN

Home Assistant läuft am zuverlässigsten per Netzwerkkabel – aber nicht jeder Raspberry Pi oder Mini-PC steht direkt neben dem Router. Die gute Nachricht: Home Assistant OS bringt alles mit, um sich per WLAN zu verbinden. In dieser Anleitung zeige ich dir drei Wege, je nachdem, ob dein Home Assistant schon erreichbar ist oder noch gar keine Verbindung hat.

Kurzantwort

Ist Home Assistant bereits per Kabel erreichbar, öffnest du Einstellungen → System → Netzwerk, klappst den Adapter wlan0 auf, suchst dein WLAN, gibst das Passwort ein und speicherst. Danach kannst du das Kabel abziehen.

Voraussetzungen

• Home Assistant OS (auf Raspberry Pi, Home Assistant Green/Yellow, Mini-PC oder als VM). Bei Home Assistant Container oder Core kümmert sich das Betriebssystem um das WLAN, nicht Home Assistant.
• Ein Gerät mit WLAN-Chip. Der Raspberry Pi 3, 4 und 5 haben WLAN eingebaut; Home Assistant Green und viele Mini-PCs ohne WLAN-Karte nicht – dort bleibt nur das Kabel.
• Name (SSID) und Passwort deines WLANs. Am stabilsten ist ein 2,4-GHz- oder gemischtes Netz mit WPA2 oder WPA3.

Weg 1: WLAN über die Oberfläche einrichten (empfohlen)

Das ist der einfachste Weg, wenn du Home Assistant für die Ersteinrichtung kurz per Kabel anschließen kannst.

1. Home Assistant im Browser öffnen, meist über http://homeassistant.local:8123.
2. Zu Einstellungen → System → Netzwerk gehen.
3. Unter Netzwerkadapter den Eintrag wlan0 aufklappen.
4. Auf WLAN suchen klicken, dein Netz auswählen und das Passwort eingeben.
5. IPv4 auf Automatisch lassen oder eine feste Adresse eintragen (siehe unten) und Speichern.
6. Ein bis zwei Minuten warten, dann das Netzwerkkabel abziehen.

Wichtig: Über WLAN bekommt Home Assistant vom Router meist eine andere IP-Adresse als über das Kabel. Erreichst du es danach nicht mehr unter der alten Adresse, probiere homeassistant.local:8123 oder schau in der Geräteliste deines Routers nach.

Weg 2: WLAN über die Kommandozeile

Hast du einen Bildschirm und eine Tastatur am Raspberry Pi oder nutzt das Add-on „Terminal & SSH“, geht es auch per Befehl. Ersetze Netzname und Passwort durch deine Daten:

ha network update wlan0 --ipv4-method auto --wifi-mode infrastructure --wifi-ssid "MeinWLAN" --wifi-auth wpa-psk --wifi-psk "MeinPasswort"

Mit ha network info prüfst du anschließend, ob wlan0 verbunden ist und welche IP-Adresse es bekommen hat.

Weg 3: Ganz ohne Kabel – WLAN per USB-Stick vorgeben

Kannst du überhaupt kein Kabel anschließen, liest Home Assistant OS beim Start eine Netzwerkkonfiguration von einem USB-Stick ein:

1. Einen USB-Stick mit FAT32 formatieren und ihm den Namen CONFIG geben.
2. Darauf den Ordner network anlegen und darin eine Textdatei my-network (ohne Dateiendung) mit diesem Inhalt speichern:

[connection]
id=my-network
uuid=72111c67-4a5d-4d5c-925e-f8ee26efb3c3
type=802-11-wireless

[802-11-wireless]
mode=infrastructure
ssid=MeinWLAN

[802-11-wireless-security]
auth-alg=open
key-mgmt=wpa-psk
psk=MeinPasswort

[ipv4]
method=auto

[ipv6]
addr-gen-mode=stable-privacy
method=auto

3. Den Stick einstecken und das Gerät einschalten bzw. neu starten. Home Assistant übernimmt die Einstellungen beim Booten.
4. Nach einigen Minuten ist Home Assistant unter http://homeassistant.local:8123 erreichbar. Den Stick kannst du danach abziehen.

Achte darauf, dass dein Editor die Datei nicht als my-network.txt speichert – Windows blendet Endungen gern aus.

Feste IP-Adresse vergeben

Ändert sich die Adresse von Home Assistant, funktionieren Lesezeichen, die App im Heimnetz und manche Integrationen nicht mehr zuverlässig. Zwei Möglichkeiten:

• Im Router reservieren (empfohlen): In der FRITZ!Box unter Heimnetz → Netzwerk beim Gerät „Diesem Netzwerkgerät immer die gleiche IPv4-Adresse zuweisen“ anhaken. Bei anderen Routern heißt das meist „DHCP-Reservierung“.
• In Home Assistant: Bei wlan0 IPv4 auf Statisch stellen und Adresse (z. B. 192.168.178.50/24), Gateway und DNS-Server des Routers eintragen. Die Adresse muss außerhalb des DHCP-Bereichs liegen.

Probleme und Lösungen

• Kein wlan0 in der Liste: Das Gerät hat keinen unterstützten WLAN-Chip. Bei Mini-PCs hilft eine unterstützte WLAN-Karte, einfacher ist ein Kabel oder ein Powerline-Adapter.
• Netz wird nicht gefunden: Viele Raspberry Pi sehen nur 2,4 GHz oder bestimmte 5-GHz-Kanäle. Teste ein 2,4-GHz-Netz und verstecke die SSID nicht.
• Verbindung bricht ab: Häufig ist das Signal am Aufstellort zu schwach oder die Stromversorgung des Pi zu knapp. Ein Original-Netzteil und ein besserer Standort lösen die meisten Abbrüche.
• Zigbee stört WLAN: Zigbee und 2,4-GHz-WLAN teilen sich das Frequenzband. Lege den Zigbee-Kanal weit weg vom WLAN-Kanal (z. B. WLAN Kanal 1, Zigbee Kanal 25) und nutze für den Zigbee-Stick ein USB-Verlängerungskabel.

Fazit

Mit Home Assistant OS ist WLAN in wenigen Minuten eingerichtet – am bequemsten über Einstellungen → System → Netzwerk. Für ein stabiles Smart Home lohnt sich trotzdem eine feste IP-Adresse, und wo es möglich ist, bleibt das Netzwerkkabel die zuverlässigste Wahl.