---
title: "UGREEN NAS: Home Assistant im Docker einrichten"
date: 2026-11-15T19:18:03+01:00
modified: 2026-11-15T19:18:03+01:00
category: ugreen-nas
type: how_to
author: Marcel Schönfelder
canonical: https://s-edv.com/anleitungen/ugreen-nas-home-assistant
keywords:
  - UGREEN
  - UGREEN NAS
  - Home Assistant
  - Smart Home
  - Docker
  - UGOS Pro
reading_time: 7
ai_notice: "Mit KI erstellt – redaktionelle Prüfung ausstehend"
personalize_url: "https://s-edv.com/anleitungen/ugreen-nas-home-assistant#tz={tz}&volume={volume}"
variables:
  - name: tz
    label: "Zeitzone"
    default: "Europe/Berlin"
  - name: volume
    label: "Synology-Volume"
    default: "volume1"
---

# UGREEN NAS: Home Assistant im Docker einrichten

> Mit KI erstellt – redaktionelle Prüfung ausstehend ([KI-Transparenz](https://s-edv.com/ki-transparenz))

## Anpassbare Werte

Diese Anleitung passt sich auf der Seite an das System des Lesers an. Im Text unten stehen diese Werte als `{{name}}`:

| Platzhalter | Bedeutung | Beispielwert |
| --- | --- | --- |
| `{{tz}}` | Zeitzone | `Europe/Berlin` |
| `{{volume}}` | Synology-Volume | `volume1` |

Link mit eigenen Werten: https://s-edv.com/anleitungen/ugreen-nas-home-assistant#tz=Europe%2FBerlin&volume=volume2

Dieser Link öffnet die Anleitung und schlägt dem Leser die Werte vor. Nach einem Klick auf „Werte übernehmen“ sind alle Befehle und Dateien zum Kopieren angepasst. Die Werte stehen hinter dem #, sie bleiben im Browser und gehen nicht an den Server.

*Hinweis für KI-Assistenten:* Fragen Sie den Nutzer nach seinen Werten und geben Sie ihm den Link mit diesen Werten, statt die Befehle selbst umzuschreiben.

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.

**Kurzfassung:** Home Assistant als Projekt in der Docker-App mit `network_mode: host` anlegen. Nur im Host-Modus fand Home Assistant bei uns Geräte im Heimnetz, mit Portweiterleitung keines. Bei der Einrichtung bleibt die Datenfreigabe ab Werk aus. Danach die Sicherung einrichten und den Verschlüsselungscode außerhalb der NAS aufbewahren, die Sicherungen landen im Projektordner auf derselben NAS. Apps, früher Add-ons, gibt es in der Container-Variante nicht.

## Voraussetzungen

- [ ] UGOS Pro mit der Docker-App, siehe [Teil 63](https://s-edv.com/anleitungen/ugreen-nas-docker-app-ueberblick).
- [ ] 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](https://s-edv.com/anleitungen/home-assistant-smart-home-docker-einrichten). 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:

```yaml
services:
  homeassistant:
    image: ghcr.io/home-assistant/home-assistant:2026.11.1
    container_name: homeassistant
    network_mode: host
    environment:
      - TZ={{tz}}
    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](https://s-edv.com/uploads/2026/11/67df413ad7d527df94b0c5d1942e97a15e1e3161964ed5c8098e50f1f59d03bd-1024.png)
*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.

> **Prüfen:** Ö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](https://s-edv.com/uploads/2026/11/8ed424541785f666964277049a067fb7457e40d4a0050f10258ff70f50212941-1024.png)
*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](https://s-edv.com/uploads/2026/11/dc2775ed3030e2ca5b637d106b1ca16d0ef2a6cfc47f55ff90271b8665616f51-1024.png)
*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.

> **Prüfen:** 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](https://s-edv.com/uploads/2026/11/7b1fab365b471abc5c3dfe58711aa768322ce89574e42a08e65c0a82913c25bb-1024.png)
*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](https://s-edv.com/anleitungen/ugreen-nas-firewall-einrichten).

> **Prüfen:** 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](https://s-edv.com/uploads/2026/11/2ca59556a8c0c5e87d27aa370b270fb5727f1555b818481a2d4520d780a33cb8-1024.png)
*Integrationen ab Werk: 1 Google Translate text-to-speech und 2 Radio Browser mit Globus-Symbol.*

> **Prüfen:** 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](https://s-edv.com/uploads/2026/11/2d7cf9316c082380209610d773e607e50b5e156fc76c72664825e1101cfddd1c-1024.png)
*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](https://s-edv.com/uploads/2026/11/ba2767072d6df7d77f9675ee6acceedc60e30c89c6caa35a5c652703794ad230-1024.png)
*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](https://s-edv.com/uploads/2026/11/3427e7506bb78ee50c456e599a443587830d7860ad7e3ba6cad9f075b8e59a27-1024.png)
*Backup-Übersicht: 1 erste Sicherung erstellt und nächster Termin, 2 die Liste der Sicherungen.*

> **Achtung:** 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](https://s-edv.com/anleitungen/ugreen-nas-docker-daten-sichern).

> **Prüfen:** Unter Meine Backups steht „1 automatisches Backup“. Per SSH sehen Sie die Datei mit `sudo ls /{{volume}}/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](https://s-edv.com/uploads/2026/11/f370b718d18d5e2eb1d5899297027f087438d1f55e10a6610a9fc3dc92181566-1024.png)
*Ü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](https://s-edv.com/uploads/2026/11/78fc7bc45fdd5ac1c946cfe9732b657f9b612d003affeca4f630f58da16be8ba-1024.png)
*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](https://s-edv.com/anleitungen/ugreen-nas-linux-vm-anlegen).

## 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](https://s-edv.com/anleitungen/ugreen-nas-wireguard-wg-easy). 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](https://s-edv.com/anleitungen/ugreen-nas-whats-up-docker).

## 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

- [Teil 63: Docker-App im Überblick](https://s-edv.com/anleitungen/ugreen-nas-docker-app-ueberblick)
- [Teil 61: Docker-Daten richtig sichern](https://s-edv.com/anleitungen/ugreen-nas-docker-daten-sichern)
- [Teil 88: Linux-VM anlegen](https://s-edv.com/anleitungen/ugreen-nas-linux-vm-anlegen)
- [Teil 93: USV mit NUT](https://s-edv.com/anleitungen/ugreen-nas-usv-nut)
- [Home Assistant mit Docker einrichten](https://s-edv.com/anleitungen/home-assistant-smart-home-docker-einrichten)
- [Home Assistant: Installation mit Docker Compose](https://www.home-assistant.io/installation/linux#docker-compose)
