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.
Ich betreibe Home Assistant in Docker, deshalb beschreibt dieser Guide den Weg, den ich tatsächlich gegangen bin. Die Installation selbst lief ohne Zwischenfall — der einzige Punkt, an dem ich kurz hängen blieb: HACS taucht danach nicht von allein auf. Home Assistant muss neu gestartet werden, bevor es sichtbar wird, und wer das überspringt, hält die Installation für gescheitert, obwohl sie es nicht ist.
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:
Dieser Einzeiler muss im Konfigurationsverzeichnis von Home Assistant laufen — dem Ordner, in dem deine configuration.yaml liegt. Bei einem Docker-Setup liegt dieser Ordner auf dem Host und wird in den Container gemountet. Du hast also die Wahl: den Installer auf dem Host im gemounteten Verzeichnis ausführen, oder in den Container wechseln und ihn dort starten. Beides funktioniert, weil beide Wege am selben Ort landen — im Ordner custom_components neben deiner Konfiguration.
Wenn du nicht sicher bist, welches Host-Verzeichnis gemountet ist, frag Docker, statt zu raten:
docker inspect -f '{{range .Mounts}}{{.Source}} -> {{.Destination}}{{"\n"}}{{end}}' homeassistantDie Zeile, deren Ziel /config ist, zeigt auf das gesuchte Verzeichnis. Den Installer woanders auszuführen ist der zweithäufigste Grund dafür, dass eine HACS-Installation scheinbar durchläuft und dann nichts passiert — die Dateien landen dort, wo Home Assistant nie nachschaut.
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.
Das ist der Schritt, den die meisten überspringen — und der einzige, der mich kurz aufgehalten hat. HACS legt Dateien in custom_components ab, und Home Assistant liest diesen Ordner ausschließlich beim Start. Bis zum Neustart existiert HACS aus Sicht von Home Assistant schlicht nicht. Ein Neuladen der Konfiguration genügt hier nicht, es muss ein vollständiger Neustart sein.
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.
Das HACS-Panel auf meiner eigenen Instanz: Repositories nach Status gruppiert, mit Downloads, Sternen und letzter Aktivität.
So prüfst du, ob die Installation wirklich geklappt hat
Bevor du auf Integrationsjagd gehst, sagen dir drei kurze Kontrollen, ob HACS sauber eingebunden ist:
HACS steht in der Seitenleiste. Wenn nicht, hast du entweder den Neustart ausgelassen oder die Dateien liegen im falschen Verzeichnis.
Unter Einstellungen → Geräte & Dienste erscheint HACS als eingerichtete Integration — nicht bloß als etwas, das man hinzufügen kann. Steht es weiterhin nur in der Hinzufügen-Liste, wurde der Einrichtungsdialog nicht abgeschlossen.
HACS zeigt beim Öffnen Repositories statt einer leeren Seite. Ein leeres HACS bedeutet fast immer, dass die GitHub-Autorisierung nicht abgeschlossen wurde.
Sehen alle drei Punkte gut aus, bist du fertig — alles Weitere ist die Frage, was du installierst.
So sieht eine fertige Installation unter Einstellungen → Geräte & Dienste aus: HACS als eingerichtete Integration, nicht nur als verfügbare.
Kurz zum Vertrauen, bevor du irgendetwas installierst
Das wird selten deutlich gesagt: Alles, was du über HACS installierst, ist Code von Dritten, der mit denselben Rechten in deinem Home-Assistant-Prozess läuft wie die mitgelieferten Integrationen. Er läuft nicht in einer Sandbox, und niemand bei Home Assistant prüft ihn. HACS ist ein Verteilweg, keine Qualitätskontrolle.
Das ist kein Grund, die Finger davon zu lassen — ich nutze mehrere HACS-Integrationen, und sie sind der Grund, warum mein Setup überhaupt etwas Interessantes tut. Es ist ein Grund, bewusst auszuwählen. Bevor ich etwas installiere, das ich nicht kenne, schaue ich, ob das Repository aktuelle Commits hat, ob Issues beantwortet werden und wie viele Leute es einsetzen. Ein Projekt, das seit zwei Jahren unberührt ist, bricht irgendwann still bei einem Home-Assistant-Update — und dann suchst du den Fehler.
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.
HACS läuft, aber die installierte Integration erscheint trotzdem nicht: Über HACS zu installieren lädt nur den Code herunter. Fast jede Integration braucht danach einen weiteren Neustart von Home Assistant und muss anschließend unter Einstellungen → Geräte & Dienste hinzugefügt werden wie jede andere Integration auch. Herunterladen ist nicht dasselbe wie Aktivieren.
Alles lief, bis ein Home-Assistant-Update kam: Eine benutzerdefinierte Integration, die eine Breaking Change nicht mitgemacht hat, lädt nicht mehr und taucht beim Start im Log auf. Prüfe erst das Repository auf ein Update, bevor du den Fehler in deiner Konfiguration suchst.
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.
Macht HACS Home Assistant langsamer?
HACS selbst fällt nicht ins Gewicht — es prüft im Hintergrund auf Updates. Ins Gewicht fällt, was du damit installierst: Jede Integration fragt Geräte oder Dienste nach eigenem Takt ab, zwanzig davon machen mehr Arbeit als drei. Das spricht für bewusste Auswahl, nicht gegen HACS.
Kann ich HACS wieder entfernen?
Ja. Lösche die Integration unter Einstellungen → Geräte & Dienste, entferne dann den Ordner hacs aus custom_components und starte neu. Achtung: Integrationen, die du über HACS installiert hast, liegen in eigenen Ordnern und bleiben bestehen — die musst du separat löschen, wenn du einen sauberen Stand willst.
Ist HACS offiziell?
Nein. HACS ist ein Community-Projekt, nicht Teil von Home Assistant, und wird vom Home-Assistant-Team nicht offiziell unterstützt. Genau deshalb ist die Vertrauensfrage weiter oben relevant.
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?.
Sobald HACS läuft, ist die schwierigere Frage, was sich überhaupt zu installieren lohnt. Ich pflege hier ein Verzeichnis der HACS-Integrationen — nach GitHub-Sternen sortiert und in Sammlungen wie Energie, Licht und Sicherheit gruppiert — damit du stöbern kannst, statt Repository-Namen zu raten.
