← Handsheets

🏠 Home Assistant

Projekt & Guide
Home Assistant (HA) ist die zentrale Smart-Home-Software — läuft bei dir als Docker-Container auf LXC 999 (IP 192.168.178.239, Port :8123). Darin steckt auch Jaschas Hub als eigener Webservice auf Port :3001. Dieses Handsheet erklärt die Umgebung, den Zugriff und — ganz wichtig — wie du das Dashboard selbst bearbeitest.

🖥️ Dein HA-Setup (Kurzreferenz)

  • LXC-Container: CT 999 „ha" auf Proxmox (Debian 12, 2GB/2Cores/16GB).
  • IP: 192.168.178.239 — nur aus dem Heimnetz oder per WireGuard, kein Internet-Proxy.
  • HA selbst: Docker-Container homeassistant/home-assistant:stable, Host-Netz, Autostart, Web-UI auf http://192.168.178.239:8123.
  • Admin-Login: Benutzer moschjosch.
  • Care-Hub: läuft zusätzlich im Container als Systemd-Service hub.service auf :3001 (Autostart). Pfad /opt/hub/, Config-Daten in /opt/ha-config/.
  • Erweiterungen: HACS + Browser Mod 3.2.1 installiert (/config/custom_components/).

🔑 Zugriff & Anmeldung

Auf HA kommen

http://192.168.178.239:8123 im Browser (Heimnetz/WireGuard). Bei der Ersteinrichtung wird ein Admin-Konto angelegt (moschjosch). Danach öffnet HA die <Übersicht>-Startseite.

Auf den Care-Hub kommen

Direkt: http://192.168.178.239:3001. Oder bequem: HA-Lovelace-Dashboard „Hab & Hub" zeigt den Hub per Iframe eingebettet (siehe unten).

🛠️ Dashboard selbst bearbeiten (HA-Lovelace)

Das ist der wichtigste Teil — wie du die HA-Startseite / das „Hab & Hub"-Dashboard anpasst.

Voraussetzung: Bearbeitungsmodus

  1. In HA rechts oben auf das Stift-/Bearbeiten-Symbol klicken (oder ⋯ → Dashboard bearbeiten).
  2. Im Menü „Dashboard bearbeiten" wählen → Lovelace-Editor öffnet sich.
  3. Karten hinzufügen: „+ Karte hinzufügen", Typ wählen (z.B. Entities, Glühbirnen, Wetter, Befehl-Karte).

Unser „Hab & Hub"-Dashboard ist YAML-gesteuert

Bei dir ist das Hauptdashboard nicht über die normale UI-Liste konfiguriert, sondern über eine YAML-Datei (ui-lovelace.yaml) + configuration.yaml. Das heißt: Du änderst die Datei (nicht den Klick-Editor), damit Änderungen gelten.

So bearbeitest du das YAML-Dashboard

  1. In den LXC-Container wechseln:
    pct enter 999
    (Von Proxmox-Host: pct exec 999 -- bash · bzw. over SSH-Kette)
  2. Container-Datei öffnen:
    vim /config/configuration.yaml
    vim /config/ui-lovelace.yaml
    (= HA-Config-Ordner im Docker; liegen meist unter /config/)
  3. Notwendige Zeilen — damit YAML-Lovelace aktiv ist (configuration.yaml):
    lovelace:
      mode: yaml
      resources:
        - url: /hacsfiles/browser_mod/browser-mod.js
          type: module
    lovelace:
      dashboards:
        hab-und-hub:
          mode: yaml
  4. Speichern & neu laden: YAML-Änderungen brauchen keinen vollen Neustart — in HA unter Einstellungen → System → „Konfiguration neu laden" (bzw. „Lovelace-Dashboard neu laden"). Reicht das nicht, Container-Dienst neu starten (siehe unten).

🏠 Care-Hub selbst bearbeiten (die Website auf :3001)

Der Hub ist eine eigene statische Website

Nicht Teil von HA selbst. Die Dateien liegen unter /opt/hub/public/ (z.B. index.html, handsheets/*.html). Ändern = Dateien editieren, dann Hub-Service neu starten (oder einfach Browser-Cache leeren, da statisch meist reicht):

pct enter 999
cd /opt/hub
systemctl restart hub.service
Alternativ ohne Restart: systemctl status hub.service prüfen und die HTML-Datei im Editor direkt neu laden (F5/Ctrl+Shift+R).

Handsheets: liegen unter /opt/hub/public/handsheets/. Eine neue anlegen = neue .html dort hin + Link im handsheets/index.html eintragen (Kategorie + Karte).

♻️ Neustart / Status (wichtig zu wissen)

  • HA-Container neu starten:
    docker restart homeassistant
    (im Container, oder docker ps für den echten Namen)
  • Hub-Service neu starten:
    systemctl restart hub.service
  • Status prüfen (alles):
    docker ps
    systemctl status hub.service

Nur Heimnetz/WireGuard: Es gibt keinen Proxy von außen — Zugriff nur im lokalen Netz oder per VPN (0.0.0.0 gebunden, aber FRITZ!Box-Forward nur intern). Möglich bewusst, damit nichts ungeschützt im Internet hängt.

📦 Hinweis: Das alte Lovelace-Format (mode: yaml an lovelace: direkt) wird in HA 2026.8 entfernt — das neue YAML-Dashboard-Format über lovelace: dashboards: ist der zukunftssichere Weg und bei dir bereits im Einsatz (siehe Hab & Hub).