← Hilfe

Die App findet mein Gateway nicht

In 9 von 10 Fällen ist es einer der ersten drei Punkte. Arbeite sie einfach von oben nach unten ab.

Zuerst das Wichtigste: Wenn in der App steht „Gerade keine Franzl-Box im WLAN sichtbar“, ist das kein Fehler. Es heißt nur, dass die automatische Suche gerade nichts sieht, und beweist nicht, dass etwas kaputt ist. Die Aktivierung funktioniert dann ganz normal über den Code aus dem Franzl-Panel. Diese Seite hilft dir, wenn danach trotzdem keine Verbindung zustande kommt.

1. Läuft das Franzl Gateway überhaupt?

In Home Assistant: Einstellungen → Apps → Franzl Gateway. Der Status muss „gestartet“ (grün) sein.

• Startet es nicht? Auf Starten tippen und eine Minute warten: Der erste Start richtet die Datenbank ein.
• Startet es gar nicht, wirf einen Blick ins Log (Reiter „Log“) und schick uns im Zweifel die letzten Zeilen.
• Läuft es, zeigt aber keinen Code? Einmal neu starten. Panel danach neu laden.

2. Sind Handy und Home Assistant im selben Netzwerk?

Für die erste Kopplung müssen beide im selben Heimnetz sein. Die typischen Stolpersteine, nach Häufigkeit:

• Gäste-WLAN. Das ist vom Hauptnetz absichtlich isoliert, dort ist dein Home Assistant unerreichbar. Kurz ins Haupt-WLAN wechseln.
• Mobile Daten aktiv, WLAN „verbunden, kein Internet“. Das Handy schickt dann alles übers Mobilfunknetz. WLAN kurz aus- und wieder einschalten.
• Home Assistant hängt an einem anderen Router oder in einem eigenen Subnetz (typisch bei Mesh-Systemen mit zweitem Router oder bei getrenntem IoT-Netz).
• AP-Isolation / „Client-Isolation“ im Router aktiv: Dann dürfen WLAN-Geräte einander grundsätzlich nicht sehen. Die Einstellung findest du meist unter WLAN → Sicherheit.

3. iPhone oder iPad: Netzwerk-Erlaubnis erteilt?

Das ist die häufigste stille Ursache. iOS fragt einmalig, ob Franzl Geräte im lokalen Netzwerk finden darf. Wurde das abgelehnt (oder unabsichtlich weggetippt), kann die App dein Gateway im WLAN grundsätzlich nicht mehr sehen, ohne jede Fehlermeldung.

Nachholen: iOS-Einstellungen → Franzl → „Lokales Netzwerk“ einschalten. Danach die App einmal komplett schließen und neu öffnen.

Auf Android gibt es diese Erlaubnis nicht; dort genügt es, im richtigen WLAN zu sein.

4. Die Suche noch einmal starten

Franzl sucht nicht nur einmal. Du kannst sie jederzeit neu anstoßen:

• Während der Aktivierung: auf Erneut suchen tippen. Sinnvoll vor allem, wenn du Franzl gerade erst installiert hast, während der Bildschirm schon offen war.
• Später, im Betrieb: Mehr → Mitglieder → Gateway-Verbindung → Im Heimnetz suchen.

Franzl geht dabei stufenweise vor: erst die schnelle Suche über den Netzwerknamen, dann, falls das nichts bringt, Gerät für Gerät durch dein Heimnetz. Letzteres dauert ein paar Sekunden länger und rettet genau die Netzwerke, in denen die schnelle Suche blockiert ist.

5. Nach einem Router-Neustart: neue Adresse

Hat dein Router frische IP-Adressen verteilt, kann Franzl unter der alten nicht mehr antworten. Die App sucht in diesem Fall von selbst neu, sobald du sie öffnest, und merkt sich die neue Adresse. Hilft das nicht, tippe einmal auf Im Heimnetz suchen.

Dauerhaft aus der Welt schaffst du das mit einer festen Adresse für deinen Home Assistant: Gerät offline nach Router-Neustart erklärt das in fünf Minuten.

6. Von unterwegs? Erst einmal zuhause koppeln.

Der Fernzugriff (ein verschlüsselter Tunnel) wird bei der Aktivierung automatisch eingerichtet, die allererste Verbindung muss aber im Heimnetz passieren.

Wenn die App unterwegs keine Verbindung zeigt, obwohl es zuhause funktioniert: Prüfe, ob dein Home Assistant Internet hat, und starte das Gateway einmal neu, dann verbindet sich der Tunnel neu.

7. Letzte Möglichkeit: Adresse von Hand eintragen

Wenn wirklich nichts hilft, kannst du Franzl direkt sagen, wo er zu finden ist: Mehr → Mitglieder → Gateway-Verbindung, dort ganz unten IP manuell eingeben (sichtbar, sobald der Expertenmodus eingeschaltet ist). Trag dort nur die IP-Adresse deines Home-Assistant-Servers ein — z. B. 192.168.1.50, ohne Port. Den Port hängt die App selbst an.

Die IP findest du in Home Assistant unter Einstellungen → System → Netzwerk oder in der Oberfläche deines Routers. Das ist bewusst der letzte Schritt: Er funktioniert zuverlässig, aber du musst ihn wiederholen, wenn sich die Adresse ändert.

Und wenn der Code nicht angenommen wird?

Nichts davon passt? Schreib uns an hi@getfranzl.com — am besten mit deinen Versionsnummern (Mehr → Software & Updates) und dem, was du schon probiert hast.