HACS, der Home Assistant Community Store, installiert Integrationen aus GitHub-Repositories, die nicht zum Lieferumfang von Home Assistant gehören. Am Ende dieser Anleitung ist HACS eingerichtet, mit deinem GitHub-Konto verbunden und eine Integration läuft in Home Assistant. Als Beispiel dient die Marstek Modbus Suite; die Schritte gelten genauso für alle anderen HACS-Integrationen, die unten aufgelistet sind.

Die Bezeichnungen in der Oberfläche können je nach Version leicht abweichen. HACS selbst erscheint in der Regel mit englischen Beschriftungen, die hier in Anführungszeichen stehen.

Vorbereitung

Du brauchst ein GitHub-Konto, weil sich HACS darüber anmeldet. Ein Konto legst du kostenlos auf github.com an. Home Assistant muss in Version 2024.4.1 oder neuer laufen und ins Internet kommen; Anfragen an GitHub und Cloudflare dürfen nicht blockiert sein. Einzelne Integrationen verlangen eine neuere Version, die Marstek Modbus Suite zum Beispiel 2025.9.0. Die Version siehst du unter „Einstellungen › Info“.

Wie du HACS herunterlädst, hängt von deiner Home-Assistant-Installation ab. Weißt du nicht, welche Art du hast, schau in der Installationsanleitung nach, der du gefolgt bist. HACS selbst ist keine App, sondern eine Integration; die App dient nur dem Herunterladen.

HACS herunterladen

Home Assistant OS oder Supervised

Hier gibt es eine App, die HACS herunterlädt. Statt „App“ hieß dieser Bereich früher „Add-on“.

Öffne in Home Assistant „Einstellungen › Apps“.
Öffne den Store zum Installieren neuer Apps (englisch „Install app“).
Klicke oben rechts auf das Dreipunkte-Menü und wähle „Repositories“.
Trage die Adresse https://github.com/hacs/addons ein.
Klicke auf „Hinzufügen“ (englisch „Add“) und schließe das Fenster.
Suche die App „Get HACS“ und öffne sie.
Klicke auf „Installieren“.
Starte die App.
Öffne den Reiter „Log“ der App und folge den dort angezeigten Anweisungen.

Wenn das Log die Installation von HACS bestätigt, starte Home Assistant neu (siehe Abschnitt „Home Assistant neu starten“) und mache bei „HACS einrichten“ weiter.

Home Assistant Container (Docker)

Öffne ein Terminal auf dem Rechner, auf dem Docker läuft. Den Namen deines Home-Assistant-Containers zeigt docker ps.
Rufe mit dem Namen deines Home-Assistant-Containers eine Shell darin auf.
Führe in dieser Shell das Download-Skript aus.
Starte Home Assistant neu und mache bei „HACS einrichten“ weiter.

docker exec -it CONTAINERNAME bash

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

Ersetze CONTAINERNAME durch den Namen deines Containers. Das Skript legt HACS im Konfigurationsordner von Home Assistant ab.

Home Assistant Core

Öffne ein Terminal, wechsle zu dem Benutzer, unter dem Home Assistant läuft, und führe wget -O - https://get.hacs.xyz | bash - aus. Starte danach Home Assistant neu.

HACS einrichten

Öffne „Einstellungen › Geräte & Dienste“.
Lade die Seite im Browser hart neu oder leere den Browser-Cache, sonst taucht HACS in der Liste womöglich nicht auf.
Klicke unten rechts auf „Integration hinzufügen“.
Suche nach „HACS“ und wähle es aus.
Bestätige die angezeigten Hinweise und klicke auf „Senden“.
Kopiere den angezeigten Gerätecode.
Öffne https://github.com/login/device.
Melde dich bei GitHub an, falls du es nicht schon bist.
Gib den Gerätecode ein und klicke auf „Continue“.
Klicke auf „Authorize HACS“.
Kehre zu Home Assistant zurück, weise HACS einem Bereich zu und klicke auf „Fertig“.

Die Anmeldung läuft über den Gerätecode (Device Flow): GitHub fragt dich, ob HACS in deinem Namen auf GitHub zugreifen darf, ohne dass du ein Passwort in Home Assistant eingibst. In der Seitenleiste von Home Assistant erscheint jetzt der Eintrag „HACS“.

Eine Integration hinzufügen

Benutzerdefiniertes Repository eintragen

Die Integrationen von sphings79 trägst du als benutzerdefiniertes Repository ein.

Öffne „HACS“ in der Seitenleiste von Home Assistant.
Klicke oben rechts auf das Dreipunkte-Menü und wähle „Custom repositories“.
Trage bei „Repository“ die Adresse der Integration ein. Für das Beispiel ist das:
Wähle als Typ „Integration“.
Klicke auf „Add“.

https://github.com/sphings79/marstek-modbus-suite

Das Repository ist jetzt in HACS bekannt. Nicht jedes GitHub-Repository funktioniert in HACS, es braucht dafür eine bestimmte Struktur; die hier aufgelisteten Projekte erfüllen sie.

Integration herunterladen

Suche in HACS nach dem Namen der Integration, für das Beispiel „Marstek Modbus Suite“, und öffne sie.
Klicke unten rechts auf „Download“.
Lasse die vorgeschlagene neueste Version stehen und bestätige.

HACS lädt die Dateien in den Ordner custom_components deiner Konfiguration. Die Integration steht danach mit dem Hinweis „Pending restart“ in der Liste, denn Home Assistant übernimmt sie erst nach einem Neustart.

Home Assistant neu starten

Öffne „Einstellungen“ und klicke oben rechts auf das Dreipunkte-Menü.
Wähle „Home Assistant neu starten“.
Bestätige den Neustart und warte, bis die Oberfläche wieder erreichbar ist.

Nach dem Neustart dauert es einen Moment, bis alles geladen ist.

Integration einrichten

Öffne „Einstellungen › Geräte & Dienste“.
Klicke unten rechts auf „Integration hinzufügen“.
Suche nach dem Namen der Integration, im Beispiel „Marstek Modbus Suite“, und wähle sie aus.
Fülle den Einrichtungsdialog aus und klicke auf „Senden“.
Weise bei Bedarf einen Bereich zu und klicke auf „Fertig“.

Welche Felder der Dialog fragt, hängt von der Integration ab. Die Marstek Modbus Suite verlangt die IP-Adresse des Modbus-TCP-Gateways, den Port (Standard 502), die Unit-ID (Standard 1) und die Geräteversion deines Speichers; in einem zweiten Schritt vergibst du einen Gerätenamen. Was eine andere Integration braucht, steht auf ihrer Seite in HACS und in ihrem Repository.

Kontrolle

Unter „Einstellungen › Geräte & Dienste“ steht die Integration jetzt als eigene Karte mit ihren Geräten und Entitäten. HACS meldet Updates künftig als Eintrag in der Liste; zum Aktualisieren öffnest du die Integration in HACS, lädst die neue Version erneut herunter und startest Home Assistant neu.

Wenn etwas nicht klappt

HACS taucht beim Hinzufügen nicht auf

Home Assistant wurde nach dem Herunterladen von HACS nicht neu gestartet, oder der Browser zeigt noch eine alte Seite. Starte Home Assistant neu und lade die Seite mit geleertem Cache hart neu.

Die Integration erscheint nicht unter „Integration hinzufügen“

Meist fehlt der Neustart nach dem Download. Starte Home Assistant neu. Hilft das nicht, leere den Browser-Cache.

HACS lehnt das Repository ab

Prüfe, ob du die Adresse richtig eingetragen und als Typ „Integration“ gewählt hast. HACS verlangt eine bestimmte Repository-Struktur, nicht jedes Repository funktioniert.

Die Anmeldung bei GitHub schlägt fehl

Der Gerätecode gilt nur kurz. Beginne die Anmeldung im Dialog von HACS erneut und gib den neuen Code ein. Prüfe außerdem, dass dein Netz Anfragen an GitHub zulässt.

HACS meldet, dass die Home-Assistant-Version zu alt ist

Die Integration setzt eine neuere Version voraus (HACS selbst 2024.4.1, die Marstek Modbus Suite 2025.9.0). Aktualisiere Home Assistant zuerst.

Weitere HACS-Integrationen

Diese Integrationen aus meinen Projekten lassen sich auf demselben Weg installieren. Trage jeweils die Adresse des Repositories als benutzerdefiniertes Repository ein.

Marstek Modbus Suite: Marstek-Venus-Speicher über lokales Modbus TCP
AmberChest für Home Assistant: Anbindung des Mailarchivs AmberChest
BLE LED Pixel Display: Bluetooth-LED-Pixelpanels
IntegrationGuard: prüft, welche HACS-Erweiterungen noch gepflegt werden
Leasing KM Calculator: Kilometerstand eines Leasingfahrzeugs gegen den Vertrag
MyIP.wtf für Home Assistant: öffentliche IPv4- und IPv6-Adresse als Sensoren
Shelly Modbus für Home Assistant: Shelly-Energiezähler und -Relais über Modbus TCP
StateGuard: überwacht markierte Entitäten und Geräte

Integration über HACS in Home Assistant installieren