HACS in Home Assistant installieren: Schritt-für-Schritt-Anleitung 2026

Du möchtest HACS in Home Assistant installieren und damit zusätzliche Integrationen, Dashboard-Karten oder Themes nutzen? Mit HACS (Home Assistant Community Store) kannst du Erweiterungen direkt über die Home-Assistant-Oberfläche entdecken, herunterladen und aktualisieren. HACS ist allerdings kein Bestandteil der offiziellen Standardinstallation – und nicht jede Community-Erweiterung wird von den Home-Assistant-Entwicklern geprüft.

Diese Schritt-für-Schritt-Anleitung zeigt dir die HACS-Installation für Home Assistant OS (zum Beispiel auf Home Assistant Green, Raspberry Pi oder Mini-PC), die anschließende GitHub-Anmeldung und die Installation deiner ersten Erweiterung. Auch den Weg für Home Assistant Container erkläre ich.

Kurz-Anleitung: In Einstellungen → Apps das Repository https://github.com/hacs/addons hinzufügen, die App Get HACS installieren und starten, ihre Protokollhinweise befolgen, Home Assistant neu starten und unter Einstellungen → Geräte & Dienste die Integration HACS hinzufügen. Danach den angezeigten Code bei GitHub autorisieren.

Was ist HACS – und wofür brauchst du es?

HACS steht für Home Assistant Community Store. Die Erweiterung ist eine Art Verwaltung für Community-Projekte, die nicht zum regulären Lieferumfang von Home Assistant gehören. Über HACS findest du beispielsweise:

• Custom Integrations: zusätzliche Anbindungen an Geräte, Dienste oder APIs, für die es keine passende offizielle Integration gibt.
• Dashboard-Karten: zusätzliche Elemente, mit denen du eine Lovelace-Oberfläche individuell gestalten kannst.
• Themes: Designs, die die Farben und das Erscheinungsbild deiner Home-Assistant-Oberfläche verändern.
• Weitere Community-Ressourcen: je nach Repository etwa Vorlagen oder andere unterstützte Erweiterungstypen.

HACS ist besonders interessant, wenn du Home Assistant individuell erweitern möchtest. Für normale Zigbee-Geräte, Standardintegrationen oder einfache Automationen brauchst du HACS dagegen oft überhaupt nicht. Die Grundlagen findest du in unserem Home-Assistant-Ratgeber für Einsteiger.

HACS, Integrationen und Apps: Was ist der Unterschied?

Wichtig: Obwohl du für die erstmalige Installation die App Get HACS verwenden kannst, ist HACS selbst eine Integration und kein eigenständiger App-Store für Home-Assistant-Apps. Genau diese Unterscheidung führt bei älteren Anleitungen oft zu Verwirrung.

Voraussetzungen für die HACS-Installation

Prüfe vor dem Start die folgenden Punkte:

• Home Assistant ab Version 2024.4.1: Dies ist die in der HACS-Dokumentation genannte Mindestversion. Am besten verwendest du eine aktuelle, unterstützte Version.
• Unterstützte Installationsart: Home Assistant OS, eine unterstützte Supervised-Installation oder eine geeignete Container-/Core-Umgebung.
• Internetzugang: Home Assistant muss unter anderem GitHub und die für HACS benötigten Dienste erreichen können.
• Zugriff auf Konfiguration und Logs: Falls die Einrichtung scheitert, solltest du Protokolle und gegebenenfalls die Konfigurationsdateien erreichen können.
• GitHub-Konto: Du brauchst ein eigenes GitHub-Konto für die spätere Autorisierung von HACS.
• Aktuelles Backup: Erstelle vor der Installation und insbesondere vor größeren Änderungen eine Sicherung. Bewahre idealerweise eine Kopie außerhalb deines Home-Assistant-Geräts auf.

Wenn du noch gar kein System eingerichtet hast, beginne bei unserem Home-Assistant-Installationsguide. Für einen unkomplizierten Einstieg eignet sich beispielsweise Home Assistant Green.

HACS installieren: Anleitung für Home Assistant OS

Dieser Weg eignet sich unter anderem für Home Assistant Green und Home Assistant OS auf Raspberry Pi, Mini-PC oder einer virtuellen Maschine. Die HACS-Entwickler empfehlen hierfür die separate Download-App Get HACS. Du musst dafür normalerweise keine Dateien manuell in den Konfigurationsordner kopieren.

Schritt 1: HACS-App-Repository hinzufügen

1. Öffne Home Assistant im Browser und melde dich mit einem Konto an, das die Einstellungen verwalten darf.
2. Öffne Einstellungen → Apps. In älteren Home-Assistant-Versionen heißt dieser Bereich eventuell noch Add-ons.
3. Öffne die Verwaltung der App-Repositories (je nach Oberfläche über das Drei-Punkte-Menü).
4. Füge dieses offizielle HACS-Repository hinzu: https://github.com/hacs/addons.
5. Bestätige das Hinzufügen. Anschließend sollte Get HACS als installierbare App erscheinen.

Der offizielle HACS-Downloadguide verweist ebenfalls auf dieses Repository. Achte darauf, nicht versehentlich irgendeine ähnlich benannte Drittanbieterquelle einzutragen.

Schritt 2: „Get HACS“ installieren und ausführen

1. Öffne die App Get HACS.
2. Wähle Installieren und starte die App danach.
3. Öffne den Bereich Protokoll/Logs der App.
4. Befolge die dort angezeigten Anweisungen. Die App lädt die Dateien für die eigentliche HACS-Integration herunter.
5. Starte Home Assistant anschließend neu. Ein bloßes Neuladen der Browserseite genügt dafür nicht.

Du findest danach nicht unbedingt ein dauerhaftes neues Programm unter „Apps“. Ziel dieses Schritts ist vielmehr, die HACS-Integration für die Einrichtung verfügbar zu machen.

Schritt 3: HACS als Integration hinzufügen

1. Öffne Einstellungen → Geräte & Dienste.
2. Falls HACS in der Integrationssuche noch nicht auftaucht, aktualisiere den Browser vollständig und leere bei Bedarf den Browsercache.
3. Klicke auf Integration hinzufügen.
4. Suche nach HACS und wähle Home Assistant Community Store.
5. Lies und bestätige die angezeigten Hinweise zu Community-Erweiterungen.
6. Setze die Einrichtung mit der GitHub-Autorisierung fort.

HACS mit GitHub verbinden und autorisieren

Bei der Ersteinrichtung öffnet HACS einen GitHub Device-OAuth-Prozess. Du musst dafür normalerweise weder ein persönliches Zugriffstoken manuell erstellen noch deine GitHub-Zugangsdaten in Home Assistant eingeben.

1. Kopiere den von HACS angezeigten Gerätecode.
2. Öffne github.com/login/device in deinem Browser.
3. Melde dich mit deinem GitHub-Konto an, falls du noch nicht angemeldet bist.
4. Gib den Gerätecode ein und bestätige ihn.
5. Wähle Authorize HACS, wenn die Berechtigungsabfrage von GitHub erscheint.
6. Wechsle zurück zu Home Assistant und schließe die Integrationseinrichtung ab.

Sicherheitstipp: Gib den Gerätecode nur auf der echten GitHub-Seite ein und teile ihn nicht öffentlich. Prüfe bei der Autorisierung, dass du tatsächlich HACS freigibst.

Nach erfolgreicher Einrichtung findest du HACS üblicherweise als eigenen Eintrag in der Home-Assistant-Seitenleiste. Von dort kannst du die verfügbaren Repositories durchsuchen.

Erste Erweiterung über HACS installieren

Ist HACS eingerichtet, kannst du ein Community-Repository herunterladen. Das Prinzip ist bei Dashboard-Karten und zusätzlichen Integrationen ähnlich, die notwendigen Schritte danach unterscheiden sich aber.

1. Öffne HACS in der Seitenleiste.
2. Nutze die Suche und gegebenenfalls den Typfilter, um ein passendes Repository zu finden.
3. Öffne dessen Detailseite und lies die Projektbeschreibung und Installationshinweise.
4. Prüfe, wann das Projekt zuletzt gepflegt wurde und ob es mit deiner Home-Assistant-Version kompatibel ist.
5. Klicke auf Download und wähle bei Bedarf eine passende Version.
6. Befolge die projektspezifischen Schritte. Bei einer Custom Integration ist nach dem Download häufig ein Neustart und anschließend die Einrichtung unter Geräte & Dienste nötig. Bei einer Dashboard-Karte können weitere Frontend-Schritte erforderlich sein.

Du kannst beispielsweise nach zusätzlichen Dashboard-Karten suchen, wenn du dein Smart Home optisch anpassen möchtest. Dabei ist entscheidend: „Heruntergeladen“ bedeutet noch nicht automatisch „vollständig eingerichtet“.

Wenn du eher Geräte über Zigbee einbinden möchtest, solltest du vorher den Unterschied zwischen den eingebauten Möglichkeiten und externen Erweiterungen kennen. Siehe dazu unseren Guide zu Zigbee und Zigbee2MQTT.

HACS in Home Assistant Container installieren

Verwendest du Home Assistant als Docker-Container, steht dir die Home-Assistant-OS-App Get HACS nicht in derselben Weise zur Verfügung. Die offizielle HACS-Anleitung beschreibt stattdessen ein Downloadskript.

1. Erstelle ein Backup und prüfe, ob du Zugriff auf die Konfigurationsdateien deines Home-Assistant-Containers hast.
2. Öffne eine Terminalverbindung zum System, auf dem Home Assistant Container läuft.
3. Öffne eine Shell innerhalb des Home-Assistant-Containers (ersetze den Platzhalter durch den tatsächlichen Containernamen):

docker exec -it <homeassistant-container> bash

Führe innerhalb des Containers das in der offiziellen HACS-Dokumentation genannte Skript aus:

wget -O - https://get.hacs.xyz | bash -

Starte anschließend den Home-Assistant-Container beziehungsweise Home Assistant neu und richte HACS wie oben unter Geräte & Dienste inklusive GitHub-Autorisierung ein.

Hinweis: Ein Skript aus dem Internet sollte nicht blind ausgeführt werden. Prüfe Herkunft und aktuellen Inhalt anhand der offiziellen HACS-Anleitung. Bei Core-Installationen gibt es ebenfalls einen terminalbasierten Weg; dort muss der Download im Kontext des Benutzers erfolgen, unter dem Home Assistant läuft.

HACS funktioniert nicht? Häufige Probleme und Lösungen

HACS wird unter „Integration hinzufügen“ nicht angezeigt

Prüfe, ob die Get HACS-App ohne Fehler durchgelaufen ist und ob Home Assistant wirklich neu gestartet wurde. Danach die Integrationssuche erneut öffnen und einen Hard-Refresh beziehungsweise das Leeren des Browsercaches versuchen. Genau darauf weist die offizielle HACS-Dokumentation hin.

GitHub-Autorisierung schlägt fehl

Öffne den von HACS angegebenen GitHub-Device-Link neu, verwende den aktuell angezeigten Code und achte darauf, mit dem gewünschten GitHub-Konto angemeldet zu sein. Prüfe außerdem die Internetverbindung sowie mögliche Sperren für GitHub.

Eine heruntergeladene Integration taucht nicht auf

Viele Custom Integrations müssen nach dem Herunterladen durch einen Home-Assistant-Neustart geladen und dann zusätzlich unter Einstellungen → Geräte & Dienste eingerichtet werden. Lies immer die Hinweise im jeweiligen Repository.

Nach einem Update gibt es Fehler

Kontrolliere die Versionshinweise des betreffenden Repositories und die Home-Assistant-Protokolle. Ein HACS-Update ist nicht automatisch dasselbe wie ein Update aller mit HACS heruntergeladenen Erweiterungen. Vor größeren Updates lohnt sich ein Backup.

HACS-Erweiterungen sicher nutzen

Community-Erweiterungen machen Home Assistant flexibel, erhöhen aber auch den Wartungsaufwand. Sie stammen von unterschiedlichen Entwicklern und können Fehler enthalten, Berechtigungen benötigen oder nach einem Home-Assistant-Update zeitweise ausfallen.

• Installiere nur Erweiterungen, die du wirklich benötigst.
• Prüfe Repository, Dokumentation, Wartungsstand und gegebenenfalls offene Fehlermeldungen.
• Erstelle vor Installation oder Aktualisierung kritischer Komponenten ein Backup.
• Halte Home Assistant und Community-Erweiterungen aktuell – aber lies vor Updates die Änderungs- und Kompatibilitätshinweise.
• Öffne nicht allein wegen HACS zusätzliche Ports ins Internet. Für den Fernzugriff gelten dieselben Sicherheitsregeln wie sonst auch; mehr dazu im Home-Assistant-Fernzugriff-Ratgeber.

HACS aktualisieren oder deinstallieren

HACS selbst aktualisieren: Wenn eine neue Version verfügbar ist, erhältst du in Home Assistant eine Update-Benachrichtigung. Prüfe unter Einstellungen → Updates die Versionshinweise, installiere die Aktualisierung und starte Home Assistant bei Bedarf neu. Die mit HACS verwalteten Community-Repositories werden dadurch nicht alle automatisch aktualisiert.

Eine Erweiterung entfernen: Öffne HACS, suche das heruntergeladene Repository und wähle über das Drei-Punkte-Menü Entfernen. Dadurch werden die heruntergeladenen Dateien entfernt; angelegte Geräte, Konfigurationen oder andere Daten können zurückbleiben. Folge deshalb zusätzlich der Anleitung des jeweiligen Projekts.

HACS vollständig entfernen: Lösche zuerst die HACS-Integration unter Einstellungen → Geräte & Dienste. Die offizielle Deinstallationsanleitung sieht anschließend zwei Neustarts, das Entfernen des Verzeichnisses custom_components/hacs und einen weiteren Neustart vor. Den GitHub-OAuth-Zugriff kannst du bei Bedarf in deinen GitHub-Anwendungseinstellungen widerrufen.

FAQ: Häufige Fragen zu HACS

Ist HACS kostenlos?

Ja. HACS ist ein frei verfügbares Open-Source-Projekt. Für die Nutzung brauchst du kein kostenpflichtiges HACS-Abonnement. Einzelne Community-Projekte können allerdings eigene Voraussetzungen oder Dienste haben.

Brauche ich HACS für Home Assistant?

Nein. Home Assistant funktioniert ohne HACS. HACS ist eine freiwillige Ergänzung für Community-Erweiterungen, die du zusätzlich verwenden möchtest.

Brauche ich für HACS ein GitHub-Konto?

Ja, die aktuelle HACS-Ersteinrichtung verwendet die Geräteautorisierung über GitHub. Du meldest dich dabei in deinem Browser direkt bei GitHub an.

Kann ich HACS auf Home Assistant Green nutzen?

Ja. Auf Home Assistant Green läuft Home Assistant OS. Die oben beschriebene Installation über Get HACS passt deshalb auch für Green.

Ist HACS dasselbe wie der offizielle Home-Assistant-App-Store?

Nein. HACS verwaltet Community-Inhalte wie Integrationen und Dashboard-Karten. Die Apps von Home Assistant OS sind eine andere Softwarekategorie; die App Get HACS dient nur dazu, HACS herunterzuladen.

Fazit: HACS lohnt sich für individuelle Home-Assistant-Setups

Wenn du über die vorhandenen Home-Assistant-Funktionen hinaus eigene Integrationen, Karten oder Themes nutzen möchtest, ist HACS ein praktisches Werkzeug. Für Home Assistant OS ist die Installation über Get HACS der einfachste Weg: Repository hinzufügen, Download-App ausführen, Home Assistant neu starten und HACS mit GitHub autorisieren.

Für ein stabiles System gilt trotzdem: So wenig zusätzliche Komponenten wie möglich, so viele wie nötig. Starte zunächst mit den offiziellen Integrationen und installiere Community-Erweiterungen gezielt.

Offizielle Quellen und weiterführende Anleitungen

• HACS: Voraussetzungen
• HACS: Installation / Download
• HACS: Ersteinrichtung mit GitHub
• HACS: Repositories verwalten
• HACS: Updates und HACS: Deinstallation

Stand: Oktober 2026. Die Menübezeichnungen können sich mit zukünftigen Home-Assistant-Versionen ändern.