HA Connect einrichten

Anleitung A: Add-on

Für Home Assistant OS oder Supervised mit App-Store / Supervisor.

1. Repository hinzufügen

Kopiere diese URL:

https://github.com/projex-aris/ha-connect-addon

1. Öffne Einstellungen → Apps → App-Store (früher: Add-on-Store).
2. Oben rechts auf das Menü ⋮ tippen und Repositories wählen.
3. Zuerst auf Hinzufügen tippen – danach öffnet sich die Eingabemaske für die URL.
4. Die Repository-URL einfügen und bestätigen.
5. Den Store aktualisieren und die App HA Connect installieren.

Alternative per CLI (wenn kein Menü «Apps» sichtbar ist, Supervisor aber läuft): ha addons repo add https://github.com/projex-aris/ha-connect-addon, danach ha addons reload und HA Connect installieren. Das ist kein Eintrag in der configuration.yaml.

2. Pairing-Code eintragen und starten

1. Im Dashboard unter ha-connect.com einen Pairing-Code erzeugen.
2. In der HA-Connect-App unter Konfiguration den Pairing-Code hinterlegen und speichern.
3. Add-on starten und die Logs prüfen.
4. Danach ist deine Instanz unter der Subdomain erreichbar.

Anleitung B: Docker / YAML

Für Container oder Core unter Ubuntu (ohne Supervisor / ohne App-Store). Hier brauchst du kein Add-on – gleiches Image als Sidecar.

1. Token und Pairing-Code

1. In Home Assistant unter dem Profil (ganz unten) einen langlebigen Zugriffstoken erstellen und kopieren.
2. Auf ha-connect.com einen Pairing-Code erzeugen.

2. Service in der docker-compose.yml

Diesen Block in deine Compose-Datei einfügen und die Platzhalter ersetzen:

ha-connect:
  container_name: ha-connect
  image: ghcr.io/projex-aris/ha-connect-addon:latest
  restart: unless-stopped
  network_mode: host
  environment:
    HA_CONNECT_DOCKER: "1"
    PAIRING_CODE: "DEIN_PAIRING_CODE"
    HA_URL: "http://127.0.0.1:8123"
    HA_TOKEN: "DEIN_LANGLEBIGER_TOKEN"
  volumes:
    - ./ha-connect-data:/data

3. Starten und Logs prüfen

1. Starten: docker compose up -d ha-connect
2. Logs: docker logs -f ha-connect

Nach dem ersten Pairing liegt der Geräte-Token unter /data – PAIRING_CODE kann danach weg.