Home Assistant mit Geräten zu Hause verbinden

Home Assistant auf blitz.cloud kann Geräte in deinem Heimnetz steuern, sobald dein Heimnetz verbunden ist und jedes Gerät unter einem Namen wie hue-bridge an Home Assistant weitergeleitet wird. Dafür brauchst du einen kleinen Linux-Rechner zu Hause, der durchläuft, etwa einen Raspberry Pi. Dein Router bleibt zu, deshalb klappt das auch mit DS-Lite und CGNAT.

Was du brauchst

• Home Assistant, installiert aus dem App Store.
• Einen Linux-Rechner in deinem Heimnetz, der ständig läuft: einen Raspberry Pi, einen Heimserver oder die Box, auf der Home Assistant bisher lief. Er verbindet dein Heimnetz mit blitz.cloud.
• Den Bereich deines Heimnetzes. Bei einer FRITZ!Box ist das meist 192.168.178.0/24, bei vielen anderen Routern 192.168.0.0/24 oder 192.168.1.0/24. Du findest ihn in den Netzwerk-Einstellungen deines Routers.

1. Das gehostete Netz verbinden

Öffne im Dashboard Private network und verbinde die Karte der WireGuard-App, falls noch nicht geschehen. Das ist das WireGuard-Netz, das blitz.cloud für dich betreibt, beschrieben unter private Netze. Nutzt du schon Tailscale oder dein eigenes WireGuard, kannst du auch dieses Netz nehmen und für Geräte, die direkt darin sind, gleich zu Schritt 4 springen.

2. Den Rechner zu Hause als Gerät hinzufügen

1. Klick auf der WireGuard-Karte auf Add a device und gib ihm einen Namen, zum Beispiel home.
2. Trag den Bereich deines Heimnetzes ein, etwa 192.168.178.0/24, als den Bereich, den dieses Gerät mitbringt.
3. Lade die Konfigurationsdatei herunter. Der Schlüssel darin wird nur einmal angezeigt und wir speichern ihn nicht, also sichere die Datei jetzt.

3. Den Rechner zu Hause einrichten

Installier auf dem Linux-Rechner WireGuard und starte die Konfiguration als Dienst. Mit der Datei unter dem Namen home.conf, auf Debian, Ubuntu oder Raspberry Pi OS:

sudo apt install wireguard
sudo cp home.conf /etc/wireguard/blitz.conf
sudo systemctl enable --now wg-quick@blitz

Unter der Konfiguration zeigt das Dashboard noch ein paar Zeilen, mit denen der Rechner Verbindungen an die anderen Geräte in deinem Netz weitergibt. Führ die auch aus. Kurz danach steht der Rechner auf der Seite Designer als online.

Der Rechner baut die Verbindung zu blitz.cloud selbst auf, am Router stellst du also nichts ein.

4. Das Gerät finden

Öffne im Dashboard Designer, wähl dein Netz aus und klick auf Scan my network. Der Scan prüft deinen Heimnetz-Bereich auf die Ports, die Geräte wie eine Hue Bridge, ein NAS, eine Kamera oder ein MQTT-Broker nutzen, und listet auf, was antwortet, mit dem Titel der Webseite, wo es eine gibt. Er läuft nur, wenn du klickst.

Ein Gerät, das der Scan nicht findet, trägst du auf der Fläche von Hand mit seiner Adresse ein, zum Beispiel 192.168.178.20.

5. Home Assistant mit dem Gerät verbinden

1. Zieh auf der Fläche eine Linie von Home Assistant zum Gerät.
2. Gib der Verbindung einen Namen. Unter diesem Namen erreicht Home Assistant das Gerät, also halte ihn kurz: hue-bridge, shelly-kueche, mqtt.
3. Wähl die Ports und ob jeder TCP oder UDP ist. Übliche Werte:

Speichern. Ein paar Sekunden später steht die Verbindung. Nur Home Assistant kann sie nutzen; deine anderen Apps erreichen das Gerät nicht, außer du ziehst auch von ihnen eine Linie.

6. Das Gerät in Home Assistant hinzufügen

Normalerweise findet Home Assistant Geräte selbst, indem es auf Rundrufe im lokalen Netz hört. Die gehen nicht durch den Tunnel, deshalb fügst du jede Integration von Hand hinzu:

1. Öffne in Home Assistant Einstellungen, Geräte & Dienste, und klick auf Integration hinzufügen.
2. Wähl die Integration, zum Beispiel Philips Hue.
3. Wo nach Host oder IP-Adresse gefragt wird, trag den Namen aus Schritt 5 ein: hue-bridge. Bei ESPHome und MQTT gibst du auch den Port an.

Bei der Hue Bridge drückst du den Knopf auf der Bridge, wenn Home Assistant danach fragt. Deine Lampen erscheinen dann wie gewohnt.

Grenzen

Home Assistant führt seine Automationen nur aus, solange es wach ist. Im kostenlosen Tarif schläft eine App nach 30 Minuten ohne Besuch ein. Automationen, die rund um die Uhr laufen sollen, brauchen also ein wach gehaltenes Home Assistant, mit Pro oder als Pro-App.

Fragen

Warum findet Home Assistant meine Geräte nicht von selbst?

Die automatische Erkennung nutzt mDNS und ähnliche Rundrufe, die nur in deinem Heimnetz unterwegs sind. Home Assistant auf blitz.cloud erreicht ein Gerät über seine Weiterleitung, unter dem Namen, den du vergeben hast. Diesen Namen trägst du beim Hinzufügen der Integration ein.

Home Assistant kommt nicht an das Gerät heran. Was prüfe ich?

Prüf, ob der Rechner zu Hause auf der Seite Designer als online steht, ob die Weiterleitung den Port hat, den die Integration nutzt, und ob das Gerät von einem anderen Gerät zu Hause unter seiner Adresse antwortet. Hat das Gerät eine neue Adresse bekommen, trägst du sie auf der Fläche neu ein. Eine feste Adresse im Router vermeidet das.

Muss ich am Router einen Port freigeben?

Nein. Der Rechner zu Hause baut die Verbindung zu blitz.cloud selbst auf, und alles läuft über diese Verbindung.