Zum Hauptinhalt springen
S-EDV news
← Alle Anleitungen
📘 Anleitung UGREEN NAS 15.11.2026 · 7 min Lesezeit Geprüft 15.11.2026

UGREEN NAS: Home Assistant im Docker einrichten

Teil 44 der UGREEN-Serie: Home Assistant in der Docker-App einrichten, warum der Host-Modus für die Gerätesuche wichtig ist, Datenfreigabe, verschlüsselte Sicherung und was die Container-Variante nicht kann.

Mit KI erstellt – redaktionelle Prüfung ausstehend

Werbung Mit * markierte Links sind Werbelinks: Bei einem Kauf erhalten wir eine Provision, der Preis bleibt gleich. Als Amazon-Partner verdiene ich an qualifizierten Verkäufen. Mehr dazu

Titelbild UGREEN by S-EDV Anleitung Teil 44: Home Assistant einrichten, mit einer NAS mit vier Laufwerksschächten

Home Assistant steuert Lampen, Steckdosen, Heizung und Medien aus einer Oberfläche, lokal und ohne Herstellercloud. Auf der UGREEN NAS läuft es als Container in der Docker-App. Diese Anleitung zeigt die Einrichtung, warum der Netzwerkmodus über die Gerätesuche entscheidet, wie Sie die eingebaute Sicherung einschalten und was die Container-Variante nicht kann.

Voraussetzungen

  • UGOS Pro mit der Docker-App, siehe Teil 63.
  • Port 8123 auf der NAS frei.
  • Gut 2,5 GB freier Platz für das Image. Im Leerlauf belegte Home Assistant bei uns 417 MiB Arbeitsspeicher.
  • Geräte, die Sie einbinden wollen, im selben Netz wie die NAS.

Was Home Assistant kann und wie Automationen funktionieren, steht in unserer allgemeinen Anleitung zu Home Assistant. Hier geht es um die Einrichtung auf der UGREEN und die Punkte, die dort anders laufen.

Schritt 1: Projekt in der Docker-App anlegen

Öffnen Sie die Docker-App, links Projekt, und klicken Sie auf Erstellen. Tragen Sie als Name homeassistant ein und wählen Sie als Speicherpfad einen neuen Ordner im freigegebenen Ordner docker, etwa docker/homeassistant. Fügen Sie diese Compose-Datei in das Feld Compose-Konfiguration ein und lassen Sie „Nach der Erstellung sofort ausführen“ angehakt:

services:
  homeassistant:
    image: ghcr.io/home-assistant/home-assistant:2026.11.1
    container_name: homeassistant
    network_mode: host
    environment:
      - TZ=Europe/Berlin
    volumes:
      - ./config:/config
    restart: unless-stopped

Die wichtigste Zeile ist network_mode: host. Damit teilt sich der Container das Netz mit der NAS und sieht Rundrufe von Geräten im Heimnetz, die Home Assistant zur Gerätesuche braucht. Einen Abschnitt ports gibt es deshalb nicht, die Oberfläche ist direkt auf Port 8123 der NAS erreichbar. In unseren Bildern tragen Projekt, Ordner und Container zusätzlich den Vorsatz s-edv.

Docker-App, Projekt erstellen mit Compose-Datei für Home Assistant und network_mode host
Projekt erstellen: 1 Name und Speicherpfad, 2 Host-Netzwerk, 3 Bereitstellen.

Klicken Sie auf Bereitstellen. Das Image belegt 2,41 GB und war bei uns nach etwa 26 Sekunden geladen.

Öffnen Sie http://IP-DER-NAS:8123 im Browser. Es erscheint die Begrüßung „Willkommen!“ mit dem Knopf „Mein Smarthome erstellen“.

Schritt 2: Home Assistant einrichten

Klicken Sie auf „Mein Smarthome erstellen“. Legen Sie Name, Benutzername und ein sicheres Passwort an und klicken Sie auf „Benutzerkonto anlegen“. Mit diesem Konto verwalten Sie Home Assistant.

Home Assistant, Benutzer erstellen mit Feldern für Name, Benutzername und Passwort
Benutzer erstellen: 1 Name, Benutzername und Passwort, 2 Benutzerkonto anlegen.

Danach fragt Home Assistant nach dem Standort. Home Assistant braucht ihn etwa für die Zeiten von Sonnenaufgang und Sonnenuntergang. Sie können eine Adresse suchen oder den Punkt auf der Karte verschieben, ab Werk steht er in Amsterdam. Im nächsten Schritt ist Deutschland als Land vorgewählt, klicken Sie auf Weiter.

Die nächste Seite zur Datenfreigabe fragt, ob Home Assistant anonymisierte Daten senden darf: Basisdaten, Nutzung, statistische Daten und Fehler-Diagnose. Alle vier Schalter sind ab Werk aus. Lassen Sie sie so, wenn nichts nach außen gehen soll, und klicken Sie auf Weiter.

Home Assistant, Seite zur Datenfreigabe mit vier ausgeschalteten Schaltern
Datenfreigabe: 1 alle vier Freigaben ab Werk ausgeschaltet.

Zum Schluss zeigt Home Assistant die Geräte, die es im Netz gefunden hat. Unter „Wir haben kompatible Geräte gefunden!“ standen bei uns 15 Integrationen. Klicken Sie auf Fertig.

Die Übersicht zeigt den Eintrag „Entdeckte Geräte“ mit der Zahl der Geräte, die Sie hinzufügen können, bei uns 17.

Schritt 3: Host-Modus oder Portweiterleitung

Viele Docker-Anleitungen leiten nur Port 8123 weiter. Wir haben das ausprobiert: Mit einer Portweiterleitung (ports mit "8123:8123") statt network_mode: host ließ sich Home Assistant normal bedienen, entdeckte aber auch nach mehr als zwei Minuten kein einziges Gerät. Zurück im Host-Modus stand der Abschnitt Entdeckt unter Einstellungen, Geräte & Dienste nach etwa 45 Sekunden wieder voll.

Home Assistant, Geräte und Dienste mit dem Abschnitt Entdeckt, Gerätenamen unkenntlich
Geräte & Dienste im Host-Modus: 1 der Abschnitt Entdeckt mit den gefundenen Geräten (unkenntlich gemacht).

Im Host-Modus öffnet Home Assistant auf der NAS TCP-Port 8123 für die Oberfläche sowie UDP 1900 und 5353 für die Gerätesuche über SSDP und mDNS. Wenn Sie die UGOS-Firewall nutzen, geben Sie Port 8123 frei, für die Gerätesuche zusätzlich UDP 1900 und 5353, siehe Teil 50.

Unter Einstellungen, Geräte & Dienste erscheint nach etwa einer Minute oben der Abschnitt Entdeckt. Fehlt er, obwohl Router oder Drucker im Netz sind, prüfen Sie, ob die Compose-Datei network_mode: host enthält.

Schritt 4: Cloud-Dienste ab Werk prüfen

Unter Einstellungen, Geräte & Dienste sind schon nach der Einrichtung sechs Integrationen vorhanden, darunter Backup, Einkaufsliste, Sonne und Thread. Zwei davon tragen ein Globus-Symbol und nutzen Internetdienste: Google Translate text-to-speech für die Sprachausgabe und Radio Browser für Internetradio. Brauchen Sie eine davon nicht, öffnen Sie die Integration, klicken Sie beim Eintrag auf das Menü mit den drei Punkten und dann auf Löschen. Home Assistant warnt, dass zugehörige Geräte und Entitäten dauerhaft gelöscht werden. Bestätigen Sie mit Löschen.

Home Assistant, Integrationen ab Werk mit Google Translate text-to-speech und Radio Browser
Integrationen ab Werk: 1 Google Translate text-to-speech und 2 Radio Browser mit Globus-Symbol.

Die gelöschte Integration steht danach nicht mehr in der Liste. Bei Radio Browser war das bei uns der Fall.

Schritt 5: Sicherung einrichten

Öffnen Sie Einstellungen, System, Backup und klicken Sie auf „Backups einrichten“. Home Assistant erzeugt einen Verschlüsselungscode aus sieben Vierergruppen. Ohne diesen Code lässt sich keine Sicherung wiederherstellen. Klicken Sie auf Herunterladen, um das Notfallset als Datei zu speichern, und legen Sie den Code zusätzlich in Ihren Passwortmanager. Klicken Sie dann auf Weiter.

Home Assistant, Verschlüsselungscode für Backups mit Knopf zum Herunterladen des Notfallsets
Verschlüsselungscode: 1 der Code (hier unkenntlich gemacht), 2 Notfallset herunterladen.

Unter „Automatische Backups einrichten“ wählen Sie Empfohlen. Home Assistant sichert dann täglich alles und hebt die Sicherungen drei Tage auf. Mit Benutzerdefiniert legen Sie Zeitpunkt, Ort und Umfang selbst fest.

Home Assistant, Automatische Backups einrichten mit Empfohlen und Benutzerdefiniert
Automatische Backups: 1 Empfohlen, täglich mit drei Tagen Aufbewahrung.

Bei uns entstand sofort die erste Sicherung mit 60 KB, die nächste plante Home Assistant für den folgenden Morgen um 5:03 Uhr. Die Datei liegt im Projektordner unter config/backups und ist verschlüsselt.

Home Assistant, Backup-Übersicht mit erster Sicherung und Liste der Backups
Backup-Übersicht: 1 erste Sicherung erstellt und nächster Termin, 2 die Liste der Sicherungen.

Die Sicherungen liegen auf derselben NAS wie Home Assistant. Fällt die NAS aus, sind beide weg. Sichern Sie den Projektordner deshalb zusätzlich auf ein anderes Gerät, siehe Teil 61.

Unter Meine Backups steht „1 automatisches Backup“. Per SSH sehen Sie die Datei mit sudo ls /volume1/docker/homeassistant/config/backups, passen Sie den Pfad an Ihr Volume an.

Was die Container-Variante nicht kann

Unter Einstellungen, Über steht als Installationsmethode „Home Assistant Container“. Das hat gegenüber dem eigenen Betriebssystem Home Assistant OS zwei Folgen.

Home Assistant, Über mit Installationsmethode Home Assistant Container
Über: 1 Installationsmethode Home Assistant Container.
  • Apps: Der Menüpunkt Einstellungen, Apps, früher Add-ons, meldet „Apps benötigen das Home Assistant OS“. Zusatzprogramme wie einen MQTT-Broker betreiben Sie stattdessen als eigene Container in der Docker-App.
  • Updates: Neue Versionen spielen Sie über die Compose-Datei ein: Versionsnummer anheben und in der Docker-App neu bereitstellen.
Home Assistant, Apps mit dem Hinweis, dass Apps das Home Assistant OS benötigen
Apps: 1 der Hinweis, dass Apps das Home Assistant OS benötigen.

Wer Apps braucht, kommt um Home Assistant OS nicht herum, etwa als virtuelle Maschine. Wie die VM-App der UGREEN funktioniert, zeigt Teil 88.

Typische Fehler

Keine Geräte entdeckt

Häufigste Ursache: Der Container läuft mit Portweiterleitung statt im Host-Modus. network_mode: host setzen und neu bereitstellen, siehe Schritt 3.

Seite nicht erreichbar nach dem Start

Port 8123 ist belegt oder die UGOS-Firewall sperrt ihn. Im Host-Modus muss der Port auf der NAS frei sein.

Login attempt failed in den Benachrichtigungen

Home Assistant meldet fehlgeschlagene Anmeldungen mit Gerätename und IP-Adresse. Bei uns kam die Meldung von einem alten Browser-Tab mit abgelaufener Sitzung. Taucht ein unbekanntes Gerät auf, prüfen Sie, wer im Netz zugreift.

Menüpunkt Apps zeigt nur einen Hinweis

In der Container-Variante gibt es keine Apps. Zusatzprogramme als eigene Container betreiben.

Häufige Fragen

Kann ich Home Assistant von unterwegs nutzen?

Ja, über ein VPN wie in Teil 48. Port 8123 sollten Sie nicht offen ins Internet stellen.

Brauche ich einen Zigbee-Stick?

Nur für Funkstandards wie Zigbee oder Z-Wave. WLAN-Geräte und vieles im Heimnetz bindet Home Assistant ohne Zusatzhardware ein, wie die entdeckten Geräte zeigen.

Wie aktualisiere ich?

Lesen Sie vorher die Versionshinweise, ändern Sie die Versionsnummer in der Compose-Datei und klicken Sie in der Docker-App beim Projekt auf Neu bereitstellen. Eine frische Sicherung vorher schadet nicht. Neue Versionen meldet What’s Up Docker, siehe Teil 69.

Fazit

Home Assistant läuft auf der UGREEN schlank, mit gut 400 MiB Arbeitsspeicher im Leerlauf, und ist in einer knappen halben Stunde eingerichtet. Entscheidend ist der Host-Modus, mit Portweiterleitung entdeckte Home Assistant bei uns kein einziges Gerät. Die Datenfreigabe ist ab Werk aus, die eingebaute Sicherung ist verschlüsselt, liegt aber auf derselben NAS. Wer Apps braucht, nimmt Home Assistant OS in einer VM.

Weiterführende Anleitungen und Quellen

UGREENUGREEN NASHome AssistantSmart HomeDockerUGOS Pro