Home Assistant installeren

Laatst bijgewerkt:

Inleiding

Home Assistant is een opensourceplatform voor huisautomatisering waarmee je apparaten beheert, hun status bekijkt en automatiseringsregels maakt op een lokaal netwerk. Naast AI-toepassingen aan de rand van het netwerk kan reComputer RK3576 Home Assistant uitvoeren als lokaal beheerknooppunt voor een woning of een klein IoT-systeem.

Deze handleiding implementeert Home Assistant Container met Docker op reComputer RK3576 en legt uit hoe je de interface in een browser opent en een account maakt.

Getest bereik: De container is gestart op reComputer RK3576 (Armbian / Debian 12 Bookworm, ARM64) en de eerste Create User-pagina is succesvol geopend.

Voorbereiding

Hardware

  • Eén reComputer RK3576 met een Linux-systeem van 64 bits dat normaal kan opstarten.
  • Eén Windows- / macOS- / Linux-computer voor toegang via een browser.
  • Een netwerkverbinding tussen RK3576 en de computer. Tijdens de installatie is internettoegang nodig om de Docker-image te downloaden.

Software

De geteste omgeving:

OnderdeelConfiguratie
HardwarereComputer RK3576
BesturingssysteemArmbian (gebaseerd op Debian 12 Bookworm)
ArchitectuurARM64 / aarch64
Container-engineDocker Engine (al geïnstalleerd op het testapparaat)
Home AssistantHome Assistant Container, image stable
Webpoort8123

Maak via SSH verbinding met RK3576 en controleer de systeeminformatie:

bash
cat /etc/os-release
uname -m

Controleer of het systeem ARM64 gebruikt, bijvoorbeeld aarch64.

Home Assistant installeren

Stap 1: Docker controleren

Controleer of Docker is geïnstalleerd en actief is:

bash
sudo docker --version
sudo systemctl status docker --no-pager

Als Docker is geïnstalleerd en de service actief is, ga je naar stap 2.

Volg anders de officiële installatiehandleiding voor Docker Engine op Debian om de repository in te stellen en Docker Engine te installeren. Gebruik een repository die bij je Armbian- / Debian-versie past en installeer geen ongecontroleerde oudere versie.

Controleer na de installatie opnieuw:

bash
sudo docker --version
sudo docker info

Home Assistant vereist Docker Engine 23.0.0 of hoger (geen Docker Desktop). Deze handleiding gebruikt Docker Engine om Home Assistant Container te implementeren.

Stap 2: De configuratiemap maken

Maak een map voor blijvende opslag van gegevens:

bash
mkdir -p "$HOME/homeassistant/config"

De configuratie en runtimegegevens worden hier opgeslagen, in plaats van alleen in de container.

Stap 3: De Home Assistant-image downloaden

Download de stabiele image uit het officiële containerregister:

bash
sudo docker pull ghcr.io/home-assistant/home-assistant:stable

Controleer de gedownloade image:

bash
sudo docker images | grep home-assistant

Stap 4: De Home Assistant-container starten

Voer deze opdracht uit op RK3576:

bash
sudo docker run -d \
  --name homeassistant \
  --restart=unless-stopped \
  --privileged \
  --network=host \
  -e TZ=Asia/Shanghai \
  -v "$HOME/homeassistant/config:/config" \
  -v /etc/localtime:/etc/localtime:ro \
  ghcr.io/home-assistant/home-assistant:stable

Deze opdracht komt overeen met de implementatie die in de RK3576-test is gebruikt:

  • --name homeassistant: stelt de containernaam in.
  • --restart=unless-stopped: start de container opnieuw nadat Docker of het apparaat opnieuw is gestart, tenzij je de container expliciet hebt gestopt.
  • --network=host: gebruikt het hostnetwerk van RK3576; Home Assistant is bereikbaar op poort 8123.
  • -e TZ=Asia/Shanghai: stelt de tijdzone in. Pas deze aan je regio aan.
  • -v "$HOME/homeassistant/config:/config": bewaart de configuratie op RK3576, zodat deze behouden blijft als je de container verwijdert.
  • --privileged: volgt het officiële Docker-voorbeeld en geeft de container uitgebreide rechten. Beoordeel deze instelling op basis van je beveiligingseisen voor productie.

Controleer de containerstatus:

bash
sudo docker ps --filter name=homeassistant
sudo docker logs --tail 50 homeassistant

De container homeassistant hoort in docker ps de status Up te hebben.

Stap 5: De webinterface openen

Zoek het IP-adres van het apparaat op RK3576:

bash
hostname -I

Open dit adres in een browser op een computer in hetzelfde netwerk:

text
http://<RK3576_IP>:8123

Als het IP-adres bijvoorbeeld 192.168.1.100 is, open je:

text
http://192.168.1.100:8123

De initialisatie bij de eerste start kan even duren. Zodra de pagina is geladen, verschijnt de Create User-pagina.

Home Assistant-pagina voor het maken van een gebruiker op reComputer RK3576

Stap 6: Een beheerdersaccount maken

Op de eerste Create User-pagina:

  1. Vul je naam en gebruikersnaam in.
  2. Stel een beheerderswachtwoord in en bevestig het.
  3. Selecteer Create account.
  4. Volg de aanwijzingen om de locatie, tijdzone en andere begininstellingen te configureren.

Na de eerste configuratie kun je de webinterface in je browser gebruiken.

Veelgestelde vragen

Hoe controleer ik of Home Assistant actief is?

Als de pagina niet bereikbaar is, controleer je de container, de logboeken en het IP-adres:

bash
sudo docker ps --filter name=homeassistant
sudo docker logs --tail 100 homeassistant
hostname -I

Hoe start ik Home Assistant opnieuw?

bash
sudo docker restart homeassistant

Opmerking: Container bevat niet de beheerfuncties Supervisor / Apps van Home Assistant OS. Implementeer en beheer afzonderlijke containers als je extra services nodig hebt.

Deze startopdracht koppelt D-Bus niet. Raadpleeg voor de Bluetooth-integratie de vereisten voor de optionele D-Bus-koppeling in de officiële installatiehandleiding voor Container.

Samenvatting

Met deze stappen kun je Home Assistant op reComputer RK3576 uitvoeren en via een webinterface configureren. Het biedt een lokaal IoT-beheerplatform en een basis om sensoren, slimme apparaten en automatiseringsservices te verbinden.

Deze handleiding richt zich op installatie en basisconfiguratie. Apparaatintegraties en automatiseringsvoorbeelden kunnen in afzonderlijke handleidingen worden behandeld.

Referenties

Technische ondersteuning en productdiscussie

Ga voor vragen over de implementatie naar het Seeed Studio Forum.