SmartHomeEntry-Agent installieren
Der Agent ist ein kleines Programm in Ihrem Heimnetz. Er baut eine ausgehende Verbindung zu unserem Server auf und macht den gewählten Dienst unter einer HTTPS-Adresse erreichbar - ohne offene Ports am Router. Wählen Sie die Installationsart, die zu Ihrer Hardware passt.
Bevor Sie beginnen
- Erstellen Sie ein Konto und wählen Sie einen Tarif.
- Klicken Sie im Dashboard auf „Installation hinzufügen“, wählen Sie das System (z. B. Home Assistant) und geben Sie seine Adresse im lokalen Netz an.
- Das Dashboard zeigt ein Installations-Token und fertige Befehle, in denen es bereits eingetragen ist. Das Token ist einmalig und bis zu 30 Minuten gültig - ist es abgelaufen, erzeugen Sie im Dashboard ein neues.
Unten finden Sie dieselben Schritte zum Ansehen vor dem Kauf. Ersetzen Sie in den Befehlen <TOKEN> durch das Token aus dem Dashboard.
Installationsart wählen
Für Home Assistant OS und Supervised-Installationen. Der Agent läuft als Add-on: kein Terminal, keine Befehle, Updates direkt in der HA-Oberfläche.
Add-on-Repository hinzufügen
Klicken Sie auf die Schaltfläche - Ihr Home Assistant öffnet sich mit eingetragener Repository-Adresse. Bestätigen Sie das Hinzufügen.
Oder manuell: Einstellungen → Add-ons → Add-on Store → ⋮ (oben rechts) → Repositories und die Adresse einfügen:
https://github.com/szyderca84/SmartHomeEntry-HA-AddonAdd-on installieren
Suchen Sie „SmartHomeEntry Agent“ in der Liste und klicken Sie auf Installieren. Falls es fehlt, laden Sie die Store-Seite neu.
Token einfügen
Öffnen Sie im Add-on den Tab Konfiguration und fügen Sie das Token aus dem SmartHomeEntry-Dashboard in das Feld install_token ein.
Speichern und starten
Klicken Sie auf Speichern und dann im Tab Info auf Starten. Der Agent verbindet sich innerhalb weniger Sekunden und das Dashboard zeigt ihn als online.
Installieren Sie den Agenten unter Home Assistant OS nicht mit dem curl-Befehl aus dem Linux-Tab oder über das Add-on „Terminal & SSH“ - es läuft in einem Container ohne systemd, der Agent würde einen Neustart nicht überstehen. Sie nutzen Home Assistant Container oder Core (ohne Supervisor)? Dann wählen Sie den Tab Docker oder Linux.
Fehlerbehebung
Wo sind die Logs
Add-on SmartHomeEntry Agent → Tab Protokoll (Aktualisieren zeigt die neuesten Einträge). Dort sehen Sie, ob der Agent die Konfiguration geladen und den Tunnel aufgebaut hat.
- Das Protokoll meldet ein ungültiges oder abgelaufenes Token - es wurde bereits verwendet oder 30 Minuten sind vergangen. Erzeugen Sie im Dashboard ein neues, fügen Sie es in der Konfiguration ein und starten Sie das Add-on neu.
- Das Add-on fehlt nach dem Hinzufügen des Repositorys - wählen Sie im Store ⋮ → Nach Updates suchen und laden Sie die Seite neu.
- Das Dashboard zeigt den Agenten online, aber die HTTPS-Adresse liefert einen Fehler - prüfen Sie im Dashboard die lokale Adresse des Dienstes. Sie muss von dem Gerät erreichbar sein, auf dem der Agent läuft (bei Home Assistant meist Port 8123).
Für Server und NAS mit Docker (Synology, QNAP, Unraid, normales Linux) sowie für Home Assistant Container. Der Agent läuft als Container, der nach einem Neustart automatisch wieder startet.
Token im Dashboard erzeugen
Dashboard → „Installation hinzufügen“. Sie erhalten den Befehl unten mit bereits eingetragenem Token und Dienstadresse - einfach kopieren.
Container starten
Führen Sie auf einem Rechner, der den Dienst im lokalen Netz erreicht, Folgendes aus:
docker run -d --name smarthomeentry-agent \ -e SMARTHOMEENTRY_INSTALL_TOKEN=<TOKEN> \ -e SMARTHOMEENTRY_API_URL=https://control.smarthomeentry.com \ -e SMARTHOMEENTRY_LOCAL_ADDR=localhost:8123 \ --network host \ --restart unless-stopped \ smarthomeentry/smarthomeentry-agent:latestSMARTHOMEENTRY_LOCAL_ADDR ist die Adresse des Dienstes aus Sicht dieses Hosts: localhost:8123 für Home Assistant auf demselben Rechner oder z. B. 192.168.1.20:5000 für ein NAS im Netz.
Docker Desktop (macOS, Windows) unterstützt --network host nicht. Lassen Sie diese Zeile weg und verwenden Sie statt localhost host.docker.internal (z. B. host.docker.internal:8123).
Voraussetzungen: Docker Engine 20+ oder Docker Desktop, Internetzugang (ausgehende Verbindung).
Fehlerbehebung
Wo sind die Logs
docker logs -f smarthomeentry-agentLäuft der Container:
docker ps --filter name=smarthomeentry-agent- Der Container startet ständig neu und das Log erwähnt das Token - es ist abgelaufen oder wurde bereits verwendet. Erzeugen Sie im Dashboard ein neues, entfernen Sie den Container smarthomeentry-agent und führen Sie den Befehl erneut aus:
docker rm -f smarthomeentry-agent - Der Tunnel steht, aber der Dienst antwortet nicht - der Container muss die lokale Adresse erreichen. Unter Linux --network host beibehalten, unter Docker Desktop host.docker.internal verwenden.
- Das Dashboard zeigt den Agenten online, aber die HTTPS-Adresse liefert einen Fehler - prüfen Sie im Dashboard die lokale Adresse des Dienstes. Sie muss von dem Gerät erreichbar sein, auf dem der Agent läuft (bei Home Assistant meist Port 8123).
Für Debian, Ubuntu, Raspberry Pi OS, Fedora und RHEL mit systemd. Das Skript installiert ein .deb- oder .rpm-Paket (amd64, arm64, armhf) und einen systemd-Dienst, der mit dem System startet.
Token im Dashboard erzeugen
Dashboard → „Installation hinzufügen“. Sie erhalten den Befehl unten mit bereits eingetragenem Token und Dienstadresse - einfach kopieren.
Installationsskript ausführen
Fügen Sie den Befehl in ein Terminal auf dem Gerät ein (z. B. per SSH auf dem Raspberry Pi):
curl -sSL https://control.smarthomeentry.com/api/install/<TOKEN> | sudo bashMöchten Sie erst lesen, was Sie ausführen? Laden Sie das Skript in eine Datei, prüfen Sie es und starten Sie es dann:
curl -sSL https://control.smarthomeentry.com/api/install/<TOKEN> -o install.sh less install.sh sudo bash install.shFertig
Der Agent läuft im Hintergrund als systemd-Dienst und startet nach einem Neustart wieder. Die Konfiguration liegt in /etc/smarthomeentry/agent.env.
Gibt es für Ihre Distribution oder Architektur kein Paket, wechselt das Skript automatisch zu Docker - die Logs finden Sie dann wie im Tab Docker beschrieben. Unter macOS nutzt das Skript immer Docker.
Voraussetzungen: Root-Rechte (sudo), systemd, curl, Internetzugang.
Fehlerbehebung
Wo sind die Logs
journalctl -u smarthomeentry-agent -fDienststatus:
systemctl status smarthomeentry-agentDienst neu starten:
sudo systemctl restart smarthomeentry-agent- Das Skript bricht mit „Run as root“ ab - führen Sie den Befehl wie oben mit sudo aus.
- Der Agent verbindet sich nicht und das Log erwähnt das Token - erzeugen Sie im Dashboard ein neues Token und führen Sie den Installationsbefehl erneut aus; das Skript überschreibt die Konfiguration.
- Das Dashboard zeigt den Agenten online, aber die HTTPS-Adresse liefert einen Fehler - prüfen Sie im Dashboard die lokale Adresse des Dienstes. Sie muss von dem Gerät erreichbar sein, auf dem der Agent läuft (bei Home Assistant meist Port 8123).
Funktioniert es immer noch nicht?
Schreiben Sie uns und fügen Sie die letzten Zeilen des Agent-Logs bei - so kommen wir am schnellsten zur Diagnose.