Home Assistant: Dein System fit machen – Update, SSH, HACS

Na, schon dein neues Home Assistant auf dem Raspi oder in einer VM auf Proxmox am Laufen? Super! Das ist der erste Schritt in eine fantastische Welt der Heimautomatisierung. Aber mal ehrlich, eine frische Installation ist wie ein Rohdiamant – da muss noch einiges geschliffen werden, bevor er wirklich glänzt. In meiner Erfahrung stolpern viele am Anfang über die gleichen Hürden. Deswegen zeige ich dir heute, wie du dein System auf den neuesten Stand bringst, dir einen ordentlichen SSH-Zugang schaffst, einen brauchbaren Editor installierst und dann das Tor zur wahren Home Assistant-Macht aufstößt: den Home Assistant Community Store (HACS).

Das hier ist kein wischiwaschi "klick hier, klick da"-Guide. Wir packen die Dinge an, wie es sich für gestandene Admins gehört. Egal ob du von ioBroker kommst oder ganz neu einsteigst – nach diesem Guide ist dein Home Assistant ready für die echten Herausforderungen.

Voraussetzungen – Was du mitbringen solltest

Bevor wir loslegen, lass uns kurz checken, ob du alles am Start hast:

Ein laufendes Home Assistant OS. Das ist die Basis, auf der wir aufbauen. Idealerweise hast du es schon in einer VM auf Proxmox oder auf einem dedizierten Mini-PC installiert.
Netzwerkzugriff auf dein Home Assistant. Du solltest die Web-Oberfläche (Frontend) erreichen können.
Grundlegendes Verständnis für Linux-Befehle und die Kommandozeile. Keine Sorge, wir halten es einfach, aber ein bisschen Vertrautheit schadet nie.
Einen SSH-Client auf deinem Rechner (z.B. PuTTY unter Windows, Terminal unter Linux/macOS).
Etwas Geduld. Manchmal braucht Home Assistant einen Moment, um Änderungen zu verarbeiten.

Begriffe klären – Dein Home Assistant Vokabular

Gerade wenn du aus der ioBroker-Welt kommst, mag sich Home Assistant anfangs ein bisschen wie eine Fremdsprache anfühlen. Aber keine Panik, die Konzepte sind die gleichen, nur die Namen sind anders. Mein Tipp: Verinnerliche diese Begriffe, das erspart dir später viel Kopfzerbrechen beim Lesen von Dokumentationen und Forenbeiträgen. Ich musste mich am Anfang auch umgewöhnen, aber einmal drin, ist es logisch.

Integration: Das ist das Äquivalent zum "Adapter" in ioBroker. Eine Integration bringt neue Geräte, Dienste oder Funktionen in Home Assistant.
HA-Frontend: Das ist quasi der "Admin" bei ioBroker – deine grafische Benutzeroberfläche, über die du alles konfigurierst und steuerst.
Entität: Stell dir das als "Datenpunkt" vor. Jedes messbare oder steuerbare Element in Home Assistant ist eine Entität (z.B. ein Lichtschalter, ein Temperatursensor, ein Bewegungsmelder).
Entitäten-Klasse: Das ist die "Rolle" einer Entität. Sie beschreibt, was für eine Art von Entität es ist (z.B. Licht, Schalter, Sensor).
Zustand (State): Der aktuelle "State" oder Wert einer Entität (z.B. Licht ist "an", Temperatur ist "22.5°C").

Wichtig zu wissen: Home Assistant OS basiert auf Alpine Linux. Früher wurde es oft als HassOS bezeichnet. Das ist relevant, wenn du mal tiefere Systembefehle absetzen musst, denn Alpine nutzt apk als Paketmanager, nicht apt wie Debian/Ubuntu.

Der erste Schritt nach der Installation: Home Assistant auf den neuesten Stand bringen

Ein frisches System ist selten wirklich aktuell. Bevor du irgendwelche tiefgreifenden Änderungen vornimmst oder Add-ons installierst, solltest du Home Assistant aktualisieren. Das ist ein grundlegender Schritt, den ich immer als Erstes mache. Warum? Weil die Entwickler ständig Fehler beheben und neue Funktionen hinzufügen. Eine alte Version kann zu Kompatibilitätsproblemen mit neuen Add-ons oder Integrationen führen.

Mein Tipp: Schau dir vor jedem größeren Update die Release Notes an! Manchmal gibt es Breaking Changes, die deine Konfiguration beeinflussen könnten. So bist du auf der sicheren Seite und vermeidest böse Überraschungen.

Das Update ist in Home Assistant glücklicherweise kinderleicht:

Melde dich im HA-Frontend an.
Gehe zu Einstellungen (das Zahnrad-Symbol).
Wähle System.
Klicke auf Updates.
Wenn ein Update verfügbar ist, siehst du es hier. Klicke einfach auf Update installieren.

Home Assistant lädt dann die neue Version herunter und installiert sie. Das System startet dabei neu. Hab ein bisschen Geduld, das kann ein paar Minuten dauern. Wenn es fertig ist, solltest du die neue Version unten links in der Seitenleiste sehen.

SSH-Zugriff einrichten – Dein direkter Draht zum System

Wer ernsthaft mit Home Assistant arbeitet, kommt um SSH nicht herum. Es ist dein Schweizer Taschenmesser für die Fehlersuche, für manuelle Konfigurationsänderungen, wenn mal das Frontend streikt, oder für die Installation von Dingen, die nicht direkt über die Oberfläche gehen. Das fehlende SSH im Standard ist mir bis heute ein Rätsel, aber wir fixen das jetzt.

SSH & Web Terminal Add-on installieren

Im HA-Frontend gehst du zu Einstellungen.
Wähle Add-ons.
Klicke unten rechts auf den Button Add-on-Store.
Suche nach "SSH & Web Terminal" (entwickelt von Home Assistant Community Add-ons).
Klicke auf das Add-on und dann auf Installieren.

Konfiguration des SSH Add-ons

Nach der Installation ist das Add-on noch nicht bereit. Du musst es konfigurieren. Das ist ein wichtiger Schritt, um Sicherheit und Funktionalität zu gewährleisten.

Nach der Installation wechselst du zum Tab Konfiguration des SSH Add-ons.
Hier findest du eine YAML-Struktur. Wir müssen mindestens ein Passwort festlegen oder SSH-Keys hinterlegen. Ich empfehle dir dringend, SSH-Keys zu verwenden. Das ist sicherer und komfortabler als ein Passwort, das du jedes Mal eingeben musst. Für den Anfang und zum Testen geht ein Passwort, aber für dein Heimlabor solltest du Keys nutzen!

Hier ist ein Beispiel für die Konfiguration, zuerst mit Passwort, dann mit SSH-Keys:


# Beispiel: Konfiguration mit Passwort (nicht empfohlen für den Produktivbetrieb)
ssh:
  authorized_keys: []
  password: "DEIN_SUPER_GEHEIMES_PASSWORT" # Ändere dies unbedingt!
  sftp: false # Kannst du bei Bedarf auf true setzen
  compatibility_mode: false

# Beispiel: Konfiguration mit SSH-Keys (empfohlen!)
ssh:
  authorized_keys:
    - "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ..." # Dein öffentlicher SSH-Key hier
    - "ssh-ed25519 AAAA..." # Oder andere Key-Typen
  password: "" # Leer lassen, wenn du nur Keys nutzt
  sftp: false
  compatibility_mode: false

Wichtig zu wissen: Wenn du SSH-Keys verwendest, musst du deinen öffentlichen Schlüssel hier eintragen. Diesen Schlüssel generierst du auf deinem Client-Rechner (z.B. mit ssh-keygen). Der private Schlüssel bleibt auf deinem Client und darf niemals das System verlassen!

Um einen SSH-Key zu generieren, falls du noch keinen hast, öffne ein Terminal auf deinem Rechner und gib ein:


ssh-keygen -t rsa -b 4096 -C "deine_email@example.com"

Folge den Anweisungen und kopiere dann den Inhalt deiner ~/.ssh/id_rsa.pub (oder wie auch immer du deinen öffentlichen Schlüssel genannt hast) Datei in die `authorized_keys`-Sektion im Add-on. Achte darauf, dass der gesamte Key in einer Zeile steht und korrekt eingerückt ist!

Nachdem du die Konfiguration gespeichert hast:

Wechsle zurück zum Tab Info des Add-ons.
Setze den Schalter Beim Start booten auf "An".
Setze den Schalter Watchdog auf "An" (damit das Add-on bei Problemen neu gestartet wird).
Klicke auf Starten.

Nun solltest du dich per SSH mit Home Assistant verbinden können. Die IP-Adresse deines Home Assistant findest du unter Einstellungen -> System -> Netzwerk. Der Standard-Port ist 22. Der Benutzername für den SSH-Zugriff ist root.


ssh root@DEINE_HOME_ASSISTANT_IP

Wenn du alles richtig gemacht hast, wirst du entweder nach deinem Passwort gefragt oder du bist direkt eingeloggt, wenn du SSH-Keys verwendet hast. Glückwunsch, du hast jetzt die volle Kontrolle über dein System!

Ein Editor muss her – YAML ist Dein Freund

Da wir jetzt SSH-Zugriff haben, könnten wir zwar Vim oder Nano auf der Kommandozeile nutzen, aber mal ehrlich: Für Konfigurationsdateien in Home Assistant ist ein grafischer Editor im Frontend viel komfortabler. Die Konfiguration von Home Assistant basiert stark auf YAML, und hier ist die richtige Einrückung (Indentation) absolut entscheidend. Ein Fehler hier und dein Home Assistant startet nicht mehr richtig. Das hat mir am Anfang viel Zeit gekostet, bis ich das im Griff hatte.

Der "File Editor" ist das Gegenstück zum SSH-Add-on und für die meisten YAML-Arbeiten im Frontend unverzichtbar.

Gehe im HA-Frontend zu Einstellungen -> Add-ons -> Add-on-Store.
Suche nach "File Editor" (ebenfalls von Home Assistant Community Add-ons).
Klicke auf das Add-on und dann auf Installieren.
Nach der Installation gehe zum Tab Info, setze Beim Start booten und Watchdog auf "An".
Klicke auf Starten.
Optional: Wenn du möchtest, dass der File Editor direkt in deiner Seitenleiste erscheint, aktiviere den Schalter In Seitenleiste anzeigen.

Jetzt hast du einen mächtigen Editor direkt in deinem Home Assistant, mit dem du Konfigurationsdateien bequem bearbeiten kannst. Er hat sogar eine grundlegende YAML-Validierung eingebaut, die dir bei der Fehlersuche hilft.

HACS installieren – Die wahre Macht von Home Assistant freischalten

Jetzt kommt der Game Changer! Der Home Assistant Community Store (HACS) ist in meiner Erfahrung das *eine* Add-on, das Home Assistant von "gut" zu "absolut fantastisch" macht. HACS ist kein offizieller Bestandteil von Home Assistant, aber eine riesige Sammlung von Community-entwickelten Integrationen, Frontend-Themes und Add-ons, die du sonst nirgendwo findest. Ohne HACS würdest du einen Großteil der Flexibilität und Erweiterbarkeit von Home Assistant verpassen.

Bevor wir HACS installieren, musst du wissen, dass es auf Git basiert. Das bedeutet, dass es Dateien von GitHub herunterlädt und verwaltet. Das SSH-Add-on bringt die notwendigen Git-Tools für uns mit.

Installation von HACS

Verbinde dich per SSH mit deinem Home Assistant (wie oben beschrieben: ssh root@DEINE_HOME_ASSISTANT_IP).
Führe den folgenden Befehl aus. Dieser lädt das HACS-Installationsskript herunter und führt es aus.


wget -q -O - https://install.hacs.xyz | bash -

Dieser Befehl ist ein Einzeiler, der zuerst das Installationsskript von hacs.xyz herunterlädt (wget -q -O -) und es dann direkt an den Bash-Interpreter weiterleitet (| bash -). Das -q steht für "quiet" (leise), und -O - sendet die Ausgabe an stdout, die dann von bash verarbeitet wird.

Die Installation dauert einen Moment. Wenn sie abgeschlossen ist, wirst du aufgefordert, Home Assistant neu zu starten.

Starte Home Assistant neu. Das kannst du entweder über das Frontend machen (Einstellungen -> System -> Neustarten) oder über SSH mit diesem Befehl:


ha core restart

Warte, bis Home Assistant wieder vollständig hochgefahren ist.

HACS als Integration hinzufügen

Nach dem Neustart musst du HACS als offizielle Integration in Home Assistant hinzufügen:

Im HA-Frontend gehe zu Einstellungen.
Wähle Geräte & Dienste.
Klicke unten rechts auf Integration hinzufügen.
Suche nach "HACS" und wähle es aus.
Es öffnet sich ein Dialog, der dich durch die Einrichtung führt. Du musst den Nutzungsbedingungen zustimmen und dann einen GitHub Personal Access Token generieren.

Wichtig zu wissen: Für den GitHub Token wirst du auf eine GitHub-Seite weitergeleitet. Dort musst du eingeloggt sein. Erstelle einen neuen Token mit den notwendigen Berechtigungen (normalerweise reicht "repo" für HACS). Kopiere diesen Token und füge ihn im Home Assistant Dialog ein. Das ist wichtig, damit HACS auf GitHub zugreifen kann, um die Community-Integrationen herunterzuladen.

Nachdem du den Token eingegeben und die Einrichtung abgeschlossen hast, ist HACS einsatzbereit! Du findest es als neuen Eintrag in deiner Seitenleiste (wenn du es aktiviert hast) oder unter Einstellungen -> Geräte & Dienste.

Jetzt kannst du im HACS-Frontend nach Tausenden von benutzerdefinierten Integrationen, Lovelace-Karten und Themes suchen und diese mit wenigen Klicks installieren. Das ist der Moment, wo dein Home Assistant wirklich anfängt, einzigartig zu werden.

Häufige Fehler und Lösungen

Auch wenn ich dir den Weg so glatt wie möglich pflastern will, passieren Fehler. Das ist normal und gehört zum Lernprozess. Hier sind ein paar Klassiker, die mir und anderen Heimlaboranten immer wieder begegnen:

Fehler 1: SSH-Login fehlgeschlagen

Du versuchst, dich per SSH zu verbinden, und es klappt nicht. Typische Meldungen sind "Permission denied" oder "Connection refused".

Lösung A (Passwort): Prüfe das Passwort im SSH Add-on. Hast du es richtig eingegeben? Ist es im YAML-Format korrekt (keine Sonderzeichen, die YAML stören könnten)? Ist der Benutzername root?
Lösung B (SSH-Keys): Hast du deinen *öffentlichen* Schlüssel korrekt in die authorized_keys-Liste im Add-on eingefügt? Jeder Key muss in einer eigenen Zeile stehen und korrekt eingerückt sein. Ist der private Schlüssel auf deinem Client-Rechner vorhanden und korrekt konfiguriert?
Lösung C (Add-on Status): Ist das SSH Add-on überhaupt gestartet? Überprüfe im HA-Frontend unter Einstellungen -> Add-ons, ob der Status des SSH Add-ons "Wird ausgeführt" ist. Wenn nicht, starte es manuell.
Lösung D (Netzwerk): Kannst du die IP deines Home Assistant anpingen? Ist Port 22 in deiner Firewall (falls vorhanden) offen?

Fehler 2: HACS Installation schlägt fehl oder HACS wird nicht als Integration gefunden

Das Skript bricht ab, oder nach dem Neustart taucht HACS nicht unter "Integration hinzufügen" auf.

Lösung A (Internetverbindung): Hat dein Home Assistant eine aktive Internetverbindung? Das HACS-Installationsskript und die Integration selbst benötigen Zugriff auf GitHub.
Lösung B (Home Assistant Neustart): Hast du Home Assistant nach der Skriptausführung *komplett* neu gestartet? Ein einfacher "Reload" der Konfiguration reicht hier nicht. Es muss ein voller Neustart sein.
Lösung C (Skript-Fehler): Wenn das Skript direkt abbricht, lies die Fehlermeldung genau. Manchmal fehlen grundlegende Pakete, die aber normalerweise mit dem SSH Add-on kommen sollten.
Lösung D (Cache): Leere den Browser-Cache. Manchmal versteckt sich HACS, weil der Browser alte Daten anzeigt.

Fehler 3: YAML-Fehler nach Bearbeitung mit dem File Editor

Du hast eine Konfigurationsdatei bearbeitet, und Home Assistant startet nicht mehr, zeigt Fehlermeldungen oder ignoriert deine Änderungen.

Lösung A (Einrückung!): Das ist der häufigste Fehler in YAML. YAML ist extrem empfindlich, was die Einrückung angeht. Nutze *immer* Leerzeichen (typischerweise 2 oder 4 pro Ebene), niemals Tabs. Der File Editor hilft hier oft schon mit Syntax-Highlighting und Warnungen.
Lösung B (Syntax): Hast du Kommas, Doppelpunkte, Bindestriche oder Anführungszeichen vergessen oder falsch gesetzt? YAML ist pingelig.
Lösung C (Konfiguration prüfen): Bevor du Home Assistant neu startest, nutze die eingebaute Konfigurationsprüfung. Gehe zu Einstellungen -> System -> Reparaturen -> Dreipunkt-Menü -> Überprüfen der Konfiguration. Das ist dein bester Freund, um Fehler zu finden, bevor sie dein System lahmlegen.
Lösung D (Neustart): Nach jeder Konfigurationsänderung musst du Home Assistant entweder neu starten oder zumindest die Konfiguration neu laden (Einstellungen -> System -> Entwicklerwerkzeuge -> YAML-Konfiguration neu laden). Bei größeren Änderungen oder neuen Integrationen ist ein voller Neustart immer sicherer.

Wenn dein Home Assistant wegen eines YAML-Fehlers gar nicht mehr startet und du nicht ins Frontend kommst, kannst du über SSH die problematische Datei bearbeiten oder umbenennen, um das System wieder zum Laufen zu bringen. Das ist der Moment, wo du dich freust, SSH eingerichtet zu haben!

Fazit und Nächste Schritte

Puh, das war jetzt einiges an Arbeit, aber du hast es geschafft! Dein Home Assistant ist jetzt nicht nur auf dem neuesten Stand, sondern du hast auch die essentiellen Werkzeuge an der Hand: sicheren SSH-Zugriff, einen komfortablen Editor und vor allem HACS – das Tor zu einer unendlichen Welt an Erweiterungen. Du bist jetzt kein Home Assistant-Anfänger mehr, sondern ein echter Tüftler, der sein System im Griff hat. Das sind die Grundpfeiler, auf denen du dein Smart Home aufbauen wirst.

Was kommt als Nächstes? Jetzt beginnt der eigentliche Spaß! Tauche ein in HACS, entdecke neue Integrationen für deine Geräte, probiere Lovelace-Themes aus, um dein Dashboard zu verschönern, oder installiere coole Frontend-Karten, die dir neue Visualisierungsmöglichkeiten bieten. Experimentiere mit den Add-ons, die Home Assistant bietet, und fange an, deine ersten Automatisierungen zu bauen. Dein Heimlabor wartet darauf, von dir erkundet zu werden!

Viel Spaß beim Tüfteln!