Instalacja agenta SmartHomeEntry
Agent to mały program w Twojej sieci domowej. Sam łączy się z naszym serwerem połączeniem wychodzącym i udostępnia wybraną usługę pod adresem HTTPS - bez otwierania portów na routerze. Wybierz sposób instalacji pasujący do Twojego sprzętu.
Zanim zaczniesz
- Załóż konto i wybierz plan.
- W panelu kliknij „Dodaj instalację”, wybierz system (np. Home Assistant) i podaj jego adres w sieci lokalnej.
- Panel pokaże token instalacyjny i gotowe komendy z tym tokenem. Token jest jednorazowy i ważny do 30 minut - jeśli wygaśnie, wygenerujesz nowy w panelu.
Poniżej te same kroki do przejrzenia przed zakupem. W komendach zamiast <TOKEN> wstaw token z panelu.
Wybierz sposób instalacji
Dla Home Assistant OS i instalacji Supervised. Agent działa jako add-on: bez terminala, bez komend, z aktualizacjami w interfejsie HA.
Dodaj repozytorium add-onu
Kliknij przycisk - otworzy się Twój Home Assistant z wpisanym adresem repozytorium. Potwierdź dodanie.
Albo ręcznie: Ustawienia → Dodatki → Sklep z dodatkami → ⋮ (prawy górny róg) → Repozytoria i wklej adres:
https://github.com/szyderca84/SmartHomeEntry-HA-AddonZainstaluj add-on
Znajdź na liście „SmartHomeEntry Agent” i kliknij Zainstaluj. Jeśli go nie widać, odśwież stronę sklepu.
Wklej token
W add-onie otwórz zakładkę Konfiguracja i w polu install_token wklej token z panelu SmartHomeEntry.
Zapisz i uruchom
Kliknij Zapisz, a potem Uruchom na zakładce Informacje. Agent połączy się w ciągu kilkunastu sekund, a panel pokaże go jako online.
Na Home Assistant OS nie instaluj agenta komendą curl z zakładki Linux ani przez add-on „Terminal & SSH” - działa on w kontenerze bez systemd, więc agent nie przetrwa restartu. Masz Home Assistant Container lub Core (bez Supervisora)? Wybierz zakładkę Docker albo Linux.
Gdy coś nie działa
Gdzie są logi
Add-on SmartHomeEntry Agent → zakładka Dziennik (w angielskim interfejsie: Log); przycisk Odśwież pokazuje najnowsze wpisy. Widać tam, czy agent pobrał konfigurację i zestawił tunel.
- Log zgłasza nieprawidłowy lub wygasły token - token był już użyty albo minęło 30 minut. Wygeneruj nowy w panelu, wklej go w Konfiguracji i uruchom add-on ponownie.
- Po dodaniu repozytorium add-onu nie ma na liście - w sklepie wybierz ⋮ → Sprawdź aktualizacje i odśwież stronę.
- Panel pokazuje agenta online, ale adres HTTPS zwraca błąd - sprawdź w panelu adres lokalny usługi. Musi być osiągalny z urządzenia, na którym działa agent (dla Home Assistanta zwykle port 8123).
Dla serwerów i NAS-ów z Dockerem (Synology, QNAP, Unraid, zwykły Linux) oraz dla Home Assistant Container. Agent działa jako kontener, który sam wstaje po restarcie.
Wygeneruj token w panelu
Panel → „Dodaj instalację”. Dostaniesz poniższą komendę z wpisanym tokenem i adresem usługi - wystarczy ją skopiować.
Uruchom kontener
Na maszynie, która widzi usługę w sieci lokalnej, uruchom:
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 to adres usługi widziany z tego hosta: localhost:8123 dla Home Assistanta na tym samym komputerze albo np. 192.168.1.20:5000 dla NAS-a w sieci.
Docker Desktop (macOS, Windows) nie obsługuje --network host. Pomiń tę linię, a zamiast localhost wpisz host.docker.internal (np. host.docker.internal:8123).
Wymagania: Docker Engine 20+ lub Docker Desktop, dostęp do internetu (połączenie wychodzące).
Gdy coś nie działa
Gdzie są logi
docker logs -f smarthomeentry-agentCzy kontener działa:
docker ps --filter name=smarthomeentry-agent- Kontener restartuje się w kółko, a log mówi o tokenie - token wygasł albo był już użyty. Wygeneruj nowy w panelu, usuń kontener smarthomeentry-agent i uruchom komendę jeszcze raz:
docker rm -f smarthomeentry-agent - Tunel działa, ale usługa nie odpowiada - kontener musi widzieć adres lokalny. Na Linuksie zostaw --network host, na Docker Desktop użyj host.docker.internal.
- Panel pokazuje agenta online, ale adres HTTPS zwraca błąd - sprawdź w panelu adres lokalny usługi. Musi być osiągalny z urządzenia, na którym działa agent (dla Home Assistanta zwykle port 8123).
Dla Debiana, Ubuntu, Raspberry Pi OS, Fedory i RHEL z systemd. Skrypt instaluje pakiet .deb lub .rpm (amd64, arm64, armhf) i usługę systemd, która startuje razem z systemem.
Wygeneruj token w panelu
Panel → „Dodaj instalację”. Dostaniesz poniższą komendę z wpisanym tokenem i adresem usługi - wystarczy ją skopiować.
Uruchom skrypt instalacyjny
Wklej komendę w terminalu urządzenia (np. przez SSH na Raspberry Pi):
curl -sSL https://control.smarthomeentry.com/api/install/<TOKEN> | sudo bashWolisz najpierw przeczytać, co uruchamiasz? Pobierz skrypt do pliku, przejrzyj go i dopiero uruchom:
curl -sSL https://control.smarthomeentry.com/api/install/<TOKEN> -o install.sh less install.sh sudo bash install.shGotowe
Agent działa w tle jako usługa systemd i wstaje po restarcie. Konfiguracja jest w pliku /etc/smarthomeentry/agent.env.
Jeśli dla Twojej dystrybucji lub architektury nie ma pakietu, skrypt sam przejdzie na instalację w Dockerze - wtedy logi sprawdzisz jak w zakładce Docker. Na macOS skrypt zawsze używa Dockera.
Wymagania: uprawnienia root (sudo), systemd, curl, dostęp do internetu.
Gdy coś nie działa
Gdzie są logi
journalctl -u smarthomeentry-agent -fStan usługi:
systemctl status smarthomeentry-agentRestart usługi:
sudo systemctl restart smarthomeentry-agent- Skrypt kończy się komunikatem „Run as root” - uruchom komendę z sudo, jak wyżej.
- Agent nie łączy się, a log mówi o tokenie - wygeneruj nowy token w panelu i uruchom komendę instalacyjną jeszcze raz; skrypt nadpisze konfigurację.
- Panel pokazuje agenta online, ale adres HTTPS zwraca błąd - sprawdź w panelu adres lokalny usługi. Musi być osiągalny z urządzenia, na którym działa agent (dla Home Assistanta zwykle port 8123).
Nadal nie działa?
Napisz do nas i dołącz kilkanaście ostatnich linii logu agenta - to najszybsza droga do diagnozy.