← Installieren

Franzl Gateway auf Home Assistant installieren

In wenigen Minuten vom App Store zum laufenden Gateway. Am Computer geht es am bequemsten, gekoppelt wird danach am Handy.

Voraussetzung: Eine laufende Home-Assistant-Installation mit App Store (Home Assistant OS oder Supervised, Version 2024.1+). Falls nicht: Starter-Weg oder Voraussetzungen.

Heißen bei dir noch „Add-ons"? Home Assistant hat diese Programme mit Version 2026.2 in Apps umbenannt. Auf älteren Versionen findest du dieselben Punkte unter Einstellungen → Add-ons und Add-on-Store — der Weg ist identisch, nur die Beschriftung ist anders.

1. App-Repository hinzufügen

Am einfachsten per Klick. Dieser Button öffnet dein eigenes Home Assistant und trägt das Franzl-Repository ein:

Ohne Button geht es manuell: In Home Assistant zu Einstellungen → Apps → App Store, oben rechts das Drei-Punkte-Menü ⋮ → Repositories, und diese Adresse einfügen:

https://github.com/franzdinhobl/franzl-addons

2. Installieren & starten

Im App Store „Franzl Gateway“ auswählen und auf Installieren tippen. Es wird ein fertiges Image geladen: kein Kompilieren, kein Terminal. Danach:

1. Starten tippen. Der erste Start kann eine Minute dauern (die eingebaute Datenbank wird eingerichtet).
2. „Beim Booten starten“ und „Watchdog“ aktivieren, so kommt Franzl nach einem Stromausfall von selbst wieder hoch.

3. App öffnen: den Rest macht Franzl

Jetzt nimmst du dein Handy — im selben WLAN wie dein Home Assistant — und öffnest die Franzl-App. Sie sucht das frisch gestartete Gateway im Heimnetz und übernimmt den Aktivierungscode direkt von ihm. In den allermeisten Fällen tippst du nur noch auf Aktivieren.

Abtippen musst du also normalerweise nichts. Falls dein Netzwerk solche Suchen nicht durchlässt, geht es genauso gut über den Code: Öffne die Oberfläche von Franzl Gateway (Reiter „Öffnen“ bzw. der Eintrag Franzl in der Seitenleiste). Dort stehen dein 9-stelliger Aktivierungscode (Großbuchstaben und Ziffern, z. B. A1B2C3D4E) und ein QR-Code zum Scannen.

Weiter: App koppeln — dort steht der ganze Ablauf mit allen drei Wegen.

Es klappt nicht? Prüfe, ob das Franzl Gateway wirklich läuft (grüner Status) und ob dein Home Assistant Internetzugang hat (fürs Laden des Images). Sonst hilft der Hilfe-Bereich: Die häufigsten Stolpersteine stehen dort mit Lösung.