Das moderne Fritz!Box Dashboard als Home Assistant App
Echtzeit-Übersicht, Netzwerktopologie, HA-Sensoren und mehr – alles in einer eleganten Oberfläche. Ändere bequem Gerätenamen, vergebe neue IP Adressen oder blockiere unerwünschte Hosts direkt aus der App heraus. Vollständig integriert in die Home Assistant Benutzeroberfläche dank Ingress.

Wenn euch die App gefällt, würde ich mich über eine Sternebewertung ⭐ freuen. 🤗

---

✨ Features

Bereich	Was ist enthalten
Dashboard	6 Live-Tiles (Modell, CPU, RAM, Temp, Hosts, IP-Pool) mit Sparklines; TRAFFIC.LIVE-Chart und sortierbare HOSTS.ACTIVE-Liste (nach Aktivität / IP / Name)
Geräteliste	Alle verbundenen Hosts mit Status, IP, MAC, Verbindungstyp, Sortierung, Suche, Internet-Sperre + Lösch-Funktion für Offline-Geräte
Geräte-Detail	Name umbenennen (mit Umlaut-Sanitizer), DHCP-IP fest reservieren, Internet sperren/freigeben, Gerät aus FRITZ!Box-Liste entfernen
Netzwerk	LAN, WAN, WLAN, DHCP – Details auf einen Blick; Mesh-Topologie-Visualisierung mit Mesh- und radialer Netzwerk-Ansicht; WLAN ein/aus pro SSID (z. B. Gastzugang); WLAN-Passwort direkt änderbar
Traffic	Download/Upload-Chart live (30 s Takt, 30 min Verlauf) + Statistiken für Heute, Gestern, Woche, Monat, Vormonat
Telefonie	Anrufliste (Von/An/Gerät getrennt, Typ-Filter) und DECT-Handsets – saubere Trennung zu SmartHome (DECT-Aktoren wie FRITZ!DECT 200/301 landen nur noch in SmartHome)
SmartHome	Übersicht aller AHA-Geräte (Steckdosen, Thermostate, Sensoren, RolloTron) mit Temperatur, Schalter-Status und Leistung
System	Fritz!Box Modell, Firmware, Uptime, Seriennummer, Neustart-Funktion; HA-Sensoren-Konfiguration, Debug-Logging, „Sitzung dauerhaft halten"
HA-Sensoren	CPU, RAM, Temp, Geräte, freie IPs, Download, Upload, Traffic-Counter – automatisch als Sensoren in Home Assistant
MQTT Discovery	Standard-Übertragungsweg: Alle Sensoren werden via MQTT als gruppiertes „FRITZ!Portal"-Gerät in HA registriert
REST-API Fallback	Optional aktivierbar für Nutzer ohne MQTT-Broker – Sensoren erscheinen dann als einzelne Entitäten
Sprache	Vollständig deutsch / englisch umschaltbar über DE/EN-Pille im Header, Auswahl bleibt persistent
Dark / Light Mode	Reaktives Theme (TERMINAL.OS Slate · Blue) ohne Reload
Ingress	Vollständige Integration in die Home Assistant Oberfläche, kein Port-Forwarding nötig

---

🚀 Installation in Home Assistant

1. Repository hinzufügen

1. In HA: Einstellungen → Apps → App Store
2. Rechts oben auf ⋮ → Benutzerdefinierte Repositories klicken
3. URL eintragen:

   https://github.com/jayjojayson/FRITZ-Portal
   

4. Hinzufügen klicken → Seite neu laden

2. App installieren

1. FRITZ!Portal im Store suchen und öffnen
2. Installieren klicken (Build dauert einige Minuten)
3. Wechsel zu Konfiguration und Zugangsdaten eintragen:

Option	Beschreibung	Standard
fritzbox_host	Hostname oder IP der Fritz!Box	fritz.box
fritzbox_user	Fritz!Box-Benutzername	–
fritzbox_password	Fritz!Box-Passwort	–
ha_sensors	REST-API Fallback aktivieren (nur ohne MQTT-Broker nötig)	false
ha_sensors_interval	Intervall Systemsensoren (Sek.)	60
ha_sensors_traffic_interval	Intervall Traffic-Sensoren (Sek.)	300
keep_session_alive	FRITZ!Box-Session permanent offen halten – nötig für kontinuierliche HA-Sensor-Updates auch wenn das Portal nicht aktiv geöffnet ist. Erhöht die FRITZ!Box-Last und kann mit der HA-eigenen Fritz!SmartHome-Integration konkurrieren – nur einschalten wenn die Sensoren wirklich rund um die Uhr aktualisiert werden müssen.	false
debug_logging	Alle API-Anfragen (TR-064, data.lua) im Protokoll ausgeben – hilfreich zur Fehlerdiagnose, ansonsten ausgeschaltet lassen	false

4. Speichern → Starten
5. Via Benutzeroberfläche öffnen oder direkt unter http://<ha-ip>:3003

Hinweis: Die App meldet sich beim Start automatisch mit den konfigurierten Zugangsdaten an der Fritz!Box an – kein manuelles Login nötig.

Fritz!Box Berechtigungen: Der verwendete Fritz!Box-Benutzer braucht folgende Berechtigungen, sonst funktionieren einzelne Bereiche der App nicht. Einstellbar in der FRITZ!Box-Oberfläche → System → FRITZ!Box-Benutzer → [Benutzer bearbeiten]:

Berechtigung	Wird benötigt für
FRITZ!Box-Einstellungen	Modell/Firmware, CPU/RAM/Temperatur, Neustart, WLAN-Konfiguration (inkl. Gastzugang ein/aus), DHCP-Reservierungen, Geräteliste löschen, Internet-Sperre
Sprachnachrichten, Faxnachrichten, FRITZ!App Fon und Anrufliste	Anrufliste auf der Telefonie-Seite
Smart Home	SmartHome-Geräte (Steckdosen, Thermostate, Sensoren, Rolladen)
VPN	optional, nur falls die Box per VPN erreichbar ist

Zusätzlich muss unter Heimnetz → Netzwerk → Netzwerkeinstellungen die Option „Zugriff für Anwendungen zulassen" aktiviert sein – sonst werden TR-064-Anfragen mit 401 Invalid Action abgelehnt.

MQTT Discovery: FRITZ!Portal sendet Sensordaten immer automatisch via MQTT an Home Assistant. Alle Sensoren werden dabei als ein gemeinsames „FRITZ!Portal"-Gerät in der HA-Geräteübersicht registriert und lassen sich dort individuell benennen, kategorisieren und auf Dashboards verwenden.

Kein MQTT-Broker vorhanden? Den REST-API Fallback in der App-Konfiguration (ha_sensors: true) oder direkt in der FRITZ!Portal-GUI aktivieren. Die Sensoren erscheinen dann als einzelne Entitäten unter Einstellungen → Entitäten. Um doppelte Entitäten zu vermeiden, sollte immer nur eine Methode aktiv sein.

---

FRITZ!Portal funktioniert grundsätzlich mit allen Fritz!Box-Modellen, die TR-064 und data.lua unterstützen. Die folgenden Modelle wurden von Nutzern getestet und laufen gut:

Modell	Status	Anmerkungen
FRITZ!Box 7590	✅ Gut	Vollständig unterstützt
FRITZ!Box 7590 AX	✅ Gut	DECT-Fix seit v1.3.8
FRITZ!Box 7530	✅ Gut	DSL/PPPoE; Mesh-Ansicht eingeschränkt (Issue #5)
FRITZ!Box 6690 Cable	✅ Gut	DECT-Fix seit v1.3.8
FRITZ!Box 6591 Cable	✅ Gut	Vollständig unterstützt seit DHCP-Fallback via data.lua seit v1.2.6
FRITZ!Box 6490 Cable	✅ Gut	Modell-Ermittlung und IP-Stats via Fallback seit v1.2.5
FRITZ!Box 6860 5G	⚠️ In Klärung	Probleme gemeldet (Issue #20)

Hinweis: Modelle, die nicht in dieser Liste stehen, funktionieren möglicherweise ebenfalls – sie wurden nur noch nicht explizit getestet.

---

🐳 Lokal mit Docker bauen & testen

Für Entwicklung und Tests ohne Home Assistant:

# Repository klonen
git clone https://github.com/jayjojayson/FRITZ-Portal.git
cd FRITZ-Portal/fritz-portal

# Docker Image bauen
docker build -t fritz-portal-app .

# Container starten (Auto-Login via Umgebungsvariablen)
docker run --rm -p 3003:3003 \
  -e FRITZBOX_HOST=fritz.box \
  -e FRITZBOX_USER=admin \
  -e FRITZBOX_PASSWORD=geheim \
  fritz-portal-app

Danach im Browser öffnen: http://localhost:3003

Nur Frontend entwickeln (Vite Dev Server)

cd fritz-portal
npm install
npm run dev

Der Dev-Server läuft auf http://localhost:5173 und proxyt API-Anfragen automatisch an den laufenden Express-Server.

---

📋 Changelog

Die vollständige Versionshistorie ist in CHANGELOG.md zu finden.

---

Made with ❤️ for the Home Assistant community