Home Assistant HACS installieren und einrichten: So funktionieren Community-Erweiterungen

Home Assistant bringt bereits viele Integrationen und Dashboard-Karten mit. Für manche Geräte oder besondere Ansichten gibt es darüber hinaus Erweiterungen aus der Community. HACS, der Home Assistant Community Store, hilft dabei, solche Projekte zu finden, herunterzuladen und zu aktualisieren.

Wichtig ist die Unterscheidung: HACS selbst ist eine benutzerdefinierte Integration für Home Assistant. Erweiterungen aus HACS stammen von unabhängigen Entwicklern und gehören nicht zum offiziellen Funktionsumfang von Home Assistant. In dieser Anleitung richten wir HACS ein und installieren anschließend eine erste Dashboard-Karte.

Was du vor der Installation brauchst

  • Home Assistant in Version 2024.4.1 oder neuer
  • Ein GitHub-Konto für die Anmeldung bei HACS
  • Zugriff auf deine Home-Assistant-Installation und eine Internetverbindung
  • Ein Backup, falls du bereits eine produktiv genutzte Installation hast

Prüfe zuerst unter Einstellungen → Über, welche Home-Assistant-Version installiert ist. Außerdem solltest du wissen, ob du Home Assistant OS, Supervised, Container oder Core verwendest. Davon hängt ab, wie HACS auf dein System heruntergeladen wird.

Schritt 1: HACS herunterladen

Home Assistant OS oder Supervised

Für Home Assistant OS und Supervised bietet das HACS-Projekt eine App namens Get HACS an. Diese App lädt die HACS-Dateien herunter. Die spätere Nutzung von HACS erfolgt trotzdem über die Integration in Home Assistant.

  1. Öffne in Home Assistant Einstellungen → Apps.
  2. Füge das App-Repository https://github.com/hacs/addons hinzu.
  3. Installiere die App Get HACS und starte sie.
  4. Öffne das Protokoll der App und folge den dort angezeigten Hinweisen.
  5. Starte Home Assistant anschließend neu.

Je nach Spracheinstellung kann „Apps“ in deiner Oberfläche noch „Add-ons“ heißen.

Home Assistant Container oder Core

Bei Container und Core erfolgt der Download über ein Terminal. Die offizielle HACS-Anleitung verwendet dafür dieses Skript:

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

Bei einer Container-Installation führst du den Befehl im laufenden Home-Assistant-Container aus. Bei Home Assistant Core wechselst du zuvor zu dem Benutzer, unter dem Home Assistant läuft. Starte Home Assistant nach dem Download neu. Die genauen Terminalschritte für deinen Installationstyp stehen in der HACS-Dokumentation.

Schritt 2: HACS als Integration einrichten

Nach dem Neustart ist HACS noch nicht vollständig eingerichtet. Gehe jetzt zu Einstellungen → Geräte & Dienste → Integration hinzufügen und suche nach HACS. Falls HACS nicht in der Liste erscheint, lade die Home-Assistant-Seite vollständig neu oder leere den Browser-Cache.

Bestätige die angezeigten Hinweise. Anschließend erhältst du einen Gerätecode und einen Link zu GitHub. Öffne den Link, melde dich bei GitHub an, gib den Code ein und bestätige Authorize HACS. Danach kehrst du zu Home Assistant zurück und schließt die Einrichtung ab.

Du musst dafür weder dein GitHub-Passwort in Home Assistant eingeben noch ein Personal Access Token erstellen. HACS verwendet für die Anmeldung den Gerätecode von GitHub.

Schritt 3: Eine Erweiterung finden und herunterladen

Nach der Einrichtung erscheint HACS in der Seitenleiste. Dort kannst du nach Erweiterungen suchen und die Ergebnisse nach Typ filtern. Besonders häufig sind zwei Arten:

  • Integrationen ergänzen Funktionen oder binden Dienste und Geräte ein. Nach dem Download müssen sie häufig noch unter Einstellungen → Geräte & Dienste eingerichtet werden. Ob weitere Schritte nötig sind, steht in der Dokumentation des jeweiligen Projekts.
  • Dashboard-Elemente ergänzen die Oberfläche, etwa um zusätzliche Karten. Sie wurden früher oft „Lovelace-Plugins“ oder „Frontend-Erweiterungen“ genannt.

Öffne vor dem Download die Projektseite in HACS und lies die Installationshinweise. Mit Download wird die Erweiterung auf deinem Home-Assistant-System gespeichert. Bei Integrationen ist danach häufig ein Neustart erforderlich. HACS zeigt einen ausstehenden Neustart oder ein verfügbares Update in der Oberfläche an.

Beispiel: Die Mushroom-Karten installieren

Für einen ersten Versuch eignen sich die Mushroom-Karten. Sie erweitern den Dashboard-Editor um zusätzliche Karten für Geräte und Entitäten.

  1. Öffne HACS und suche nach Mushroom.
  2. Öffne den Eintrag des Projekts und klicke auf Download.
  3. Lade Home Assistant nach dem Download im Browser neu.
  4. Öffne ein Dashboard, wechsle in den Bearbeitungsmodus und füge eine Karte hinzu.
  5. Suche in der Kartenauswahl nach einer Mushroom-Karte und wähle eine vorhandene Entität aus.

Welche Karten verfügbar sind und wie sie eingestellt werden, beschreibt das Mushroom-Projekt auf seiner GitHub-Seite. Eine eigene YAML-Datei brauchst du für dieses Beispiel nicht.

Wenn eine Dashboard-Karte nicht erscheint

Prüfe zuerst, ob der Download in HACS abgeschlossen ist. Lade danach die Home-Assistant-Seite vollständig neu. Wird die Karte weiterhin nicht erkannt, sieh unter Einstellungen → Dashboards → Drei-Punkte-Menü → Ressourcen nach, ob die JavaScript-Ressource der Karte eingetragen ist. Je nach Ansicht ist dafür der erweiterte Modus im Benutzerprofil nötig.

Falls du eine Ressource manuell eintragen musst, verwende den Pfad aus der Dokumentation des jeweiligen Projekts und als Typ JavaScript-Modul. Bei über HACS geladenen Karten beginnt die Adresse üblicherweise mit /hacsfiles/. Eine GitHub-Seite oder Release-URL ist an dieser Stelle kein Ersatz für die lokal bereitgestellte Ressource.

Updates und Sicherheit

HACS informiert dich über neue Versionen heruntergeladener Erweiterungen. Lies vor einem Update die Versionshinweise des Projekts, besonders bei Integrationen, die Automationen oder wichtige Geräte betreffen. HACS lädt Community-Code herunter; eine Aufnahme in HACS ist keine Sicherheitsfreigabe durch das Home-Assistant-Projekt.

Halte deshalb ein aktuelles Backup bereit und installiere nur Erweiterungen, deren Zweck und Pflegezustand du nachvollziehen kannst. Bei einem Fehler helfen zunächst die Home-Assistant-Protokolle und die Dokumentation des betroffenen Projekts. Ein Problem mit einer bestimmten Karte oder Integration meldest du am besten beim jeweiligen Entwickler.

Häufige Fragen

Kann ich HACS mit Home Assistant OS, Container und Core verwenden?

Ja, sofern die Voraussetzungen der aktuellen HACS-Version erfüllt sind. Der Weg zum Herunterladen unterscheidet sich je nach Installationstyp; die anschließende Einrichtung als Integration erfolgt in der Home-Assistant-Oberfläche.

Ist HACS selbst eine App oder ein Add-on?

Nein. HACS ist eine benutzerdefinierte Integration. Für Home Assistant OS und Supervised gibt es lediglich die App „Get HACS“, die beim Herunterladen der benötigten Dateien hilft.

Brauche ich ein GitHub-Token?

Nein. Für die normale Einrichtung benötigst du ein GitHub-Konto und bestätigst die Anmeldung über einen Gerätecode.

Warum erscheint eine heruntergeladene Integration nicht sofort?

Viele Integrationen benötigen nach dem Download einen Neustart von Home Assistant. Danach musst du sie häufig noch unter „Geräte & Dienste“ hinzufügen. Maßgeblich sind die Hinweise auf der Projektseite.

Fazit

HACS macht Community-Erweiterungen in Home Assistant leichter zugänglich. Wenn du den Installationstyp beachtest, die GitHub-Anmeldung abschließt und die Hinweise der einzelnen Projekte liest, ist die Einrichtung überschaubar. Für den Einstieg reicht eine einzelne Dashboard-Karte. So kannst du in Ruhe prüfen, wie HACS auf deinem System funktioniert, bevor du weitere Erweiterungen installierst.

Weiterführende Informationen: HACS installieren · HACS einrichten · Erweiterungen mit HACS verwalten

„Diese Anleitung setzt eine eingerichtete Home-Assistant-Installation voraus. Wenn du gerade anfängst, lies zuerst den Überblick über Home Assistant und anschließend die ersten Schritte nach der Installation. Erstelle vor der Installation von Community-Erweiterungen ein Backup.“