Home Assistant mit Docker Compose: Smart Home Setup auf Linux

Home Assistant ist eine leistungsstarke Open-Source-Plattform zur Automatisierung von Smart-Home-Geräten. Mit Docker Compose lässt sich Home Assistant schnell, stabil und updatefähig auf Linux betreiben. Durch die Nutzung von persistenten Volumes, separaten Netzwerken und optionalen Add-ons können Konfigurationen, Automationen und Daten sicher gespeichert und gewartet werden.

Grundkomponenten eines Home Assistant-Stacks

Ein typischer Home Assistant-Stack besteht aus:

• Home Assistant Container: Die Hauptanwendung zur Steuerung von Smart-Home-Geräten
• Add-ons und Integrationen: Optional, z. B. MQTT-Broker, Node-RED oder InfluxDB
• Volumes: Persistente Speicherung von Konfigurationen, Automationen, Logs und Daten
• Netzwerke: Interne Kommunikation zwischen Home Assistant, Add-ons und Host

Volumes für Persistenz

Persistente Volumes sind essenziell, um Automationen, Konfigurationen und Daten bei Container-Neustarts zu erhalten.

volumes:
  homeassistant_config:
  mqtt_data:
  nodered_data:

• homeassistant_config für Konfigurationen und Automationen
• mqtt_data für persistente Speicherung des MQTT-Brokers
• nodered_data für Node-RED-Workflows
• Volumes bleiben auch bei Neustart oder Update der Container erhalten

Netzwerke für interne Kommunikation

Separate Netzwerke sorgen für sichere Kommunikation zwischen Home Assistant, Add-ons und Host-System.

networks:
  ha_frontend:
  ha_backend:

• ha_frontend verbindet Home Assistant mit externen Clients (z. B. Smartphone)
• ha_backend verbindet Home Assistant mit Add-ons wie MQTT oder Node-RED
• Trennung erhöht Sicherheit und Übersichtlichkeit

Beispiel: docker-compose.yml für Home Assistant

version: '3.8'
services:

homeassistant:

image: ghcr.io/home-assistant/home-assistant:stable

container_name: homeassistant

restart: unless-stopped

privileged: true

network_mode: host

volumes:

- homeassistant_config:/config

environment:

- TZ=Europe/Berlin
mqtt:

image: eclipse-mosquitto:2

container_name: mqtt

restart: unless-stopped

ports:

- "1883:1883"

- "9001:9001"

volumes:

- mqtt_data:/mosquitto/config

networks:

- ha_backend
nodered:

image: nodered/node-red:latest

container_name: nodered

restart: unless-stopped

ports:

- "1880:1880"

volumes:

- nodered_data:/data

networks:

- ha_backend
volumes:

homeassistant_config:

mqtt_data:

nodered_data:
networks:

ha_frontend:

ha_backend:

Erklärungen zur Compose-Datei

• Home Assistant: Container läuft im host Netzwerkmodus für direkten Zugriff auf Geräte, persistente Konfiguration im Volume
• MQTT: Broker für Gerätekommunikation, Ports für TCP und WebSockets
• Node-RED: Workflow-Engine zur Automatisierung, persistente Speicherung von Flows
• Volumes: Sichern Konfigurationen, Automationen und Add-on-Daten
• Netzwerke: Backend-Netzwerk für interne Dienste, Frontend optional für externen Zugriff
• Privileged: Erlaubt Home Assistant den Zugriff auf Hardware (z. B. Zigbee, Z-Wave)

Start und Verwaltung des Home Assistant-Stacks

Starten Sie den Stack mit einem Befehl:

docker-compose up -d

Zum Stoppen und Entfernen aller Container, Netzwerke und Volumes:

docker-compose down -v

Best Practices

• Volumes für Konfigurationen und Add-ons nutzen
• Separate Netzwerke für interne Add-ons und externen Zugriff definieren
• Regelmäßige Backups der Volumes erstellen
• Privileged-Mode nur bei Bedarf aktivieren
• Monitoring und Logs aktivieren
• Versionierte Docker Images verwenden, um Rollbacks zu ermöglichen
• Reverse Proxy optional für SSL und sichere externe Zugriffe einsetzen
• Automatische Updates mit Vorsicht und Backup-Strategie

Praxisbeispiele

Home Assistant starten

docker-compose up -d

Logs überwachen

docker-compose logs -f homeassistant
docker-compose logs -f mqtt
docker-compose logs -f nodered

Rollback auf vorherige Image-Version

docker service update --image ghcr.io/home-assistant/home-assistant:2026.3 homeassistant_service

Updatefähigkeit

Durch versionierte Docker Images können Home Assistant und Add-ons unkompliziert aktualisiert werden, während Volumes unverändert bleiben. Backups der Konfiguration und Add-ons gewährleisten, dass Daten und Automationen erhalten bleiben.

docker-compose pull
docker-compose up -d

Zusammenfassung

Mit Docker Compose lässt sich Home Assistant auf Linux schnell, stabil und updatefähig betreiben. Persistente Volumes, separierte Netzwerke und Best Practices wie Backups, Monitoring und Reverse Proxy sorgen für Sicherheit, Wartbarkeit und Zuverlässigkeit. Versionierte Images erleichtern Updates und Rollbacks, wodurch ein langfristig stabiler Smart-Home-Betrieb gewährleistet wird.

Konfiguriere Cisco Router & Switches und liefere ein Packet-Tracer-Lab/GNS3

Ich biete professionelle Unterstützung im Bereich Netzwerkkonfiguration und Network Automation für private Anforderungen, Studienprojekte, Lernlabore, kleine Unternehmen sowie technische Projekte. Ich unterstütze Sie bei der Konfiguration von Routern und Switches, der Erstellung praxisnaher Topologien in Cisco Packet Tracer, dem Aufbau und Troubleshooting von GNS3- und EVE-NG-Labs sowie bei der Automatisierung von Netzwerkaufgaben mit Netmiko, Paramiko, NAPALM und Ansible. Kontaktieren Sie mich jetzt – klicken Sie hier.

Meine Leistungen umfassen:

• Professionelle Konfiguration von Routern und Switches

• Einrichtung von VLANs, Trunks, Routing, DHCP, NAT, ACLs und weiteren Netzwerkfunktionen

• Erstellung von Topologien und Simulationen in Cisco Packet Tracer

• Aufbau, Analyse und Fehlerbehebung von Netzwerk-Labs in GNS3 und EVE-NG

• Automatisierung von Netzwerkkonfigurationen mit Python, Netmiko, Paramiko, NAPALM und Ansible

• Erstellung von Skripten für wiederkehrende Netzwerkaufgaben

• Dokumentation der Konfigurationen und Bereitstellung nachvollziehbarer Lösungswege

• Konfigurations-Backups, Optimierung bestehender Setups und technisches Troubleshooting

Benötigen Sie Unterstützung bei Ihrem Netzwerkprojekt, Ihrer Simulation oder Ihrer Network-Automation-Lösung? Kontaktieren Sie mich jetzt – klicken Sie hier.