Home Assistant HACS: Vollständiger Leitfaden zur Installation, Einrichtung und ersten Erweiterungen

📖 Einleitung: Warum HACS unverzichtbar ist

Home Assistant (HA) ist bereits aus der Box heraus leistungsfähig, doch die wahze Stärke des Open-Source-Ökosystems liegt in der Community. Der Home Assistant Community Store (HACS) ist das offizielle Erweiterungs-Repository, das seit 2021 den veralteten custom_updater ersetzt hat. HACS ermöglicht:

🔹 Installation von Custom Integrations (z. B. für nicht-offiziell unterstützte Hardware)
🔹 Bereitstellung von Custom Lovelace Cards für hochgradig anpassbare Dashboards
🔹 Automatische Updates, Versionierung und Abhängigkeitsmanagement
🔹 Trennung von Core- und Community-Code für stabilere HA-Updates

Dieser Artikel führt dich professionell durch die Installation, Konfiguration und den Einsatz der ersten HACS-Erweiterungen – optimiert für Home Assistant Core/OS/Container (Version 2023.10 bis 2025.x).

🛠️ Voraussetzungen

Komponente	Empfehlung
Home Assistant	2023.10 oder neuer
Zugriff	SSH/Web Terminal, Samba oder File Editor Add-on
GitHub-Konto	Kostenlos (für API-Rate-Limits erforderlich)
Browser	Chrome, Firefox oder Edge (aktuell)
Grundwissen	YAML-Struktur, HA-Dashboards, Netzwerk-Basics

⚠️ Hinweis: HACS ist kein Add-on, sondern eine Integration. Sie wird direkt in Home Assistant eingebunden.

📦 Schritt 1: HACS installieren

✅ Offizielle Methode (UI-basiert, empfohlen)

Seit Home Assistant 2021.2 ist die Installation direkt über die Weboberfläche möglich:

Öffne http://<HA-IP>:8123
Gehe zu Einstellungen → Geräte & Dienste → Integration hinzufügen
Suche nach HACS und klicke darauf
Bestätige die Sicherheitswarnung („Community-Integration“)
Gib deine GitHub-Zugangsdaten ein (Benutzername + Token)
Klicke auf Speichern

🔧 Alternative: Manuelle Installation (Fallback)

Falls die UI-Methode fehlschlägt:

bash# Terminal/SSH auf dem HA-Host
cd /usr/share/hassio
git clone https://github.com/hacs/integration.git custom_components/hacs
systemctl restart homeassistant

📌 Pfade können je nach Installation (Docker, Supervised, Add-on Store) variieren. Nutze ha core info, um den korrekten Pfad zu ermitteln.

⚙️ Schritt 2: HACS konfigurieren

Nach der Installation erscheint HACS im linken Menü. Beim ersten Öffnen wirst du zu einer Konfigurationsseite weitergeleitet:

GitHub-Registrierung: HACS benötigt ein Personal Access Token, um GitHub-API-Limits zu umgehen.
- Erstelle ein Token unter github.com/settings/tokens
- Berechtigungen: public_repo (ausreichend)
Installationstyp wählen:
- Full: Alle Repositories (empfohlen)
- Minimal: Nur offizielle & HACS-eigene Repos
HACS-Status prüfen: Ein grünes Icon bedeutet „ready“. Rot/Weiß = Fehler (siehe Troubleshooting).
Kategorien auswählen: Integration, Plugin, Theme, Template – je nach Bedarf.

🧩 Schritt 3: Erste Erweiterungen installieren

HACS unterscheidet zwischen Integrations (Backend) und Frontend (Custom Cards). Beide werden im HACS-Dashboard unter den jeweiligen Tabs verwaltet.

🔹 1. HACS Integration (Steuerung via Home Assistant)

Suche im HACS-Dashboard nach HACS
Installiere die Integration
Nach Neustart erscheint HACS als neue Integration in den Einstellungen
✅ Nutzen: Direkte HACS-Verwaltung ohne Sidebar, automatische Synchronisation

🔹 2. Custom Lovelace Cards (Frontend)

Empfohlene Starter-Pakete:

Card	Zweck	Repo
`button-card`	Hochgradig anpassbare Status-/Aktionsbuttons	`custom/button-card`
`mushroom`	Moderne, minimalistische Kartenfamilie	`custom/mushroom`
`slider-entity-row`	Schieberegler direkt in Entitäten-Listen	`custom/slider-entity-row`
`lovelace-gen`	Dashboard-Generierung via YAML	`custom/lovelace-gen`

Installationsablauf:

Im HACS-Dashboard unter Frontend nach dem Namen suchen
Klick auf Install
Warte auf „Downloaded“ → Restart Home Assistant

🔹 3. Ressourcen registrieren

Custom Cards müssen Home Assistant bekannt gemacht werden:

Methode A: Über die UI (empfohlen, HA 2022+)

Einstellungen → Dashboard → Drei Punkte → Ressourcen verwalten
Ressource hinzufügen → URL eingeben (z. B. https://github.com/custom/button-card/releases/latest/button-card.js)
Typ: JavaScript Module

Methode B: Manuell in ui-lovelace.yaml

yamlresources:
  - url: /hacsfiles/button-card/button-card.js
    type: module
  - url: /hacsfiles/mushroom/mushroom.js
    type: module

🔍 Tipp: Nutze ha config show, um den Pfad zu ui-lovelace.yaml zu ermitteln.

🛡️ Schritt 4: Erste Anpassung & Validierung

YAML-Validierung durchführen

bashha core check

oder im File Editor: Configuration.yaml → Check Configuration

Beispiel: `button-card` in einem Dashboard

yamltype: custom:button-card
entity: light.living_room
name: Wohnzimmer
icon: mdi:lightbulb
state:
  - value: 'on'
    color: orange
    styles:
      card:
        - background-color: '#333'
  - value: 'off'
    color: grey

📌 type: custom:button-card muss exakt so lauten. Tippfehler führen zu Unknown card type.

🚨 Troubleshooting: Häufige Probleme & Lösungen

Symptom	Ursache	Lösung
HACS zeigt rotes Icon	GitHub-Rate-Limit, falscher Token, CORS	Token erneuern, `hacs/integration` Repo prüfen, Browser-Cache leeren
Custom Card lädt nicht	Ressourcen nicht registriert, falscher Pfad	`ui-lovelace.yaml` prüfen, `developer-tools/yaml` validieren
`Failed to load resource`	HACS-Server nicht erreichbar	Netzwerk/Firewall prüfen, `hacs` Add-on (falls vorhanden) starten
HA stürzt nach Installation ab	Inkompatible HA-Version, defektes Repo	HACS → `Clear Cache` → HA-Neustart → Repo-Update prüfen

Diagnose-Tipps:

Developer Tools → YAML → Check Configuration
Supervisor → Logs → Core nach ERROR filtern
HACS-Dashboard → Info → Logs für detaillierte Fehler

📐 Best Practices für produktive HACS-Nutzung

Regelmäßige Updates: HACS → Check for Updates → wöchentlich ausführen
Nur vertrauenswürdige Repos: HACS filtert automatisch inkompatible Projekte. Ignoriere Warnungen nur mit Bedacht.
Ressourcen-Management: Alte/deprecated Cards entfernen, um Dashboard-Overhead zu reduzieren
Backup vor Änderungen: ha backup create oder offizielle HA-Backup-Add-ons nutzen
Version-Pinning für kritische Systeme: In hacs.json oder custom_components/ Tag/Commit fixieren
Ressourcen-Typ prüfen: module vs js vs css – falscher Typ bricht Dashboards

📝 Fazit

HACS ist das Rückgrat eines skalierbaren Home Assistant. Mit der offiziellen UI-Installation, korrekter GitHub-Registrierung und diszipliniertem Ressourcen-Management wird HACS zu einem stabilen, wartbaren Werkzeug. Die ersten Custom Cards öffnen die Tür zu professionellen Dashboards, während Custom Integrations die Hardware-Grenzen von HA erweitern.

🔜 Nächste Schritte: Automatisierungen mit node-red, Energie-Dashboards, MQTT-Brücken oder HA-Cloud-Integrationen.

❓ Häufig gestellte Fragen (FAQ)

Q: Kann ich HACS auf Home Assistant OS, Core und Container nutzen?
A: Ja. Die Installation unterscheidet sich nur im Pfad (/usr/share/hassio vs /config). Die UI-Methode ist plattformübergreifend identisch.

Q: Warum zeigt HACS „Red“ oder „White“?
A: Rot = kritischer Fehler (API, Netzwerk, Version). Weiß = Warte auf Synchronisation oder manuelle Prüfung. Prüfe Logs und GitHub-Repo-Status.

Q: Sind Custom Cards sicher?
A: HACS prüft Repos auf Kompatibilität und bekannte Sicherheitslücken. Installiere nur Cards mit aktiven Maintainer, >1k Downloads und transparentem Code.

Q: Wie deinstalliere ich HACS vollständig?
A: HACS → Remove → Integration deinstallieren → custom_components/hacs löschen → Browser-Cache leeren → HA neustarten.