Du möchtest Custom-Integrationen, Themes oder Dashboard-Karten nutzen, die nicht im Standard-Katalog von Home Assistant stehen? Dann brauchst du HACS – den Home Assistant Community Store. (Was HACS genau ist, erkläre ich in Was ist HACS?.) Diese Anleitung führt dich Schritt für Schritt durch die Installation – vom Download über die GitHub-Autorisierung bis zur ersten Integration.
Voraussetzungen
Eine laufende Home-Assistant-Installation. Du musst wissen, welchen Typ du fährst (HAOS/Supervised vs. Container/Core) – die Install-Methode unterscheidet sich.
Container / Core: Terminal-Zugriff auf das Config-Verzeichnis. HAOS / Supervised: kein Terminal nötig.
Ein kostenloses GitHub-Konto – HACS lädt seine Integrationen über GitHub.
HACS installieren – Schritt für Schritt
1. HACS herunterladen
HAOS / Supervised (die häufigste Variante): Einstellungen → Add-ons → Add-on-Store → ⋮ (oben rechts) → Repositories, und https://github.com/hacs/addons hinzufügen. Dann das Add-on Get HACS installieren, starten und den Anweisungen in den Add-on-Logs folgen.
Container / Core: den offiziellen Installer im Home-Assistant-Config-Verzeichnis ausführen:
wget -O - https://get.hacs.xyz | bash -2. Home Assistant neu starten
Einstellungen → System → Neu starten. Home Assistant erkennt die neue Integration erst nach einem Neustart.
3. HACS-Integration hinzufügen
Einstellungen → Geräte & Dienste → Integration hinzufügen, dann nach HACS suchen. Wichtig: HACS erscheint erst, wenn du den Browser-Cache leerst oder einen Hard-Refresh machst – das ist der häufigste "HACS taucht nicht auf"-Grund. Anschließend die Hinweise bestätigen und absenden.
4. Mit GitHub autorisieren und abschließen
HACS nutzt einen GitHub-Device-OAuth-Flow: den angezeigten Geräte-Code kopieren, github.com/login/device öffnen, einloggen, den Code eingeben und HACS autorisieren. Zurück in Home Assistant HACS einem Bereich zuweisen und auf Fertig klicken.
5. Erste Integration installieren
HACS erscheint nun in der Seitenleiste. Öffne es, durchsuche die verfügbaren Integrationen, installiere eine und starte Home Assistant neu. Fertig.
Häufige Probleme
HACS taucht nicht in der Integrationsliste auf: Browser-Cache leeren oder Hard-Refresh (offiziell der häufigste Grund), und prüfen, ob du Home Assistant neu gestartet hast.
HACS bleibt leer: die GitHub-Autorisierung (Schritt 4) wurde übersprungen.
GitHub rate limit: ein paar Minuten warten und die Autorisierung erneut durchführen.
Häufige Fragen
Ist HACS kostenlos?
Ja – HACS ist quelloffen und vollständig kostenlos.
Brauche ich ein GitHub-Konto?
Ja – HACS lädt seine Integrationen über GitHub, ein kostenloses Konto ist also erforderlich.
Funktioniert HACS mit Home Assistant Container oder Core?
Ja – der One-Line-Installer funktioniert auf allen Installationsarten. Auf HAOS ist das Get-HACS-Add-on der einfachste Weg.
Wie aktualisiere ich HACS-Integrationen?
HACS zeigt verfügbare Updates direkt im Panel an; ein Klick plus Neustart genügt.
Nächster Schritt
HACS läuft. Lerne als Nächstes, was HACS ist und warum es ein Muss für jeden Home-Assistant-Nutzer ist, in Was ist HACS?.
