Installation

Welche Methode ist die richtige?

Home Assistant kann auf verschiedene Arten installiert werden. Die Empfehlung für die meisten Nutzer ist Home Assistant Operating System (HA OS) — ein komplettes Betriebssystem, das alles mitbringt.

Was bedeutet "Supervisor"? Der Supervisor ist eine Verwaltungsschicht, die Add-ons, Backups, Updates und das Betriebssystem zentral steuert. Ohne Supervisor musst du alles manuell verwalten.

Hardware-Empfehlungen

Die Wahl der richtigen Hardware ist entscheidend für ein reibungsloses Smart Home:

Praxis-Tipp: Für die meisten Haushalte reicht ein Raspberry Pi 4/5 aus. Wenn du Kamera-Streams, lokale Spracherkennung (Whisper/Piper) oder viele Geräte (>100) nutzen willst, nimm einen Mini-PC mit x86-Prozessor und mindestens 8 GB RAM.

HA OS auf Raspberry Pi installieren (Empfohlen)

Das ist der einfachste Weg. Du brauchst:

• Einen Raspberry Pi 4 oder 5 (mind. 2 GB RAM, 4 GB empfohlen)
• Eine SD-Karte (mind. 32 GB, besser 64 GB) oder SSD über USB
• Ein Netzteil (USB-C, 5V/3A für Pi 4 oder 5V/5A für Pi 5)
• Ein Ethernet-Kabel (empfohlen) oder WLAN
• Raspberry Pi Imager auf deinem Computer

Schritt 1: Image herunterladen und flashen

1. Lade den Raspberry Pi Imager herunter: https://www.raspberrypi.com/software/
2. Öffne den Imager und wähle unter "Betriebssystem" → "Other specific-purpose OS" → "Home assistants and home automation" → Home Assistant
3. Wähle dein Pi-Modell und die SD-Karte als Ziel
4. Klicke auf "Schreiben" und warte, bis der Vorgang abgeschlossen ist

Häufiger Fehler: Beim Pi Imager nicht unter "Einstellungen" SSH oder Hostnamen ändern — das überschreibt die HA OS Konfiguration! Einfach ohne zusätzliche Einstellungen flashen.

Schritt 2: Pi starten

1. Stecke die SD-Karte in den Pi
2. Verbinde Ethernet-Kabel (oder konfiguriere WLAN)
3. Schließe das Netzteil an — der Pi startet automatisch
4. Warte 5–10 Minuten beim ersten Start (kann auch 20 Min dauern!)

Tipp: Während der Erstinstallation werden im Hintergrund Pakete heruntergeladen. Der Fortschritt ist unter http://homeassistant.local:8123 sichtbar — dort steht "Preparing Home Assistant". Nicht den Stecker ziehen!

Schritt 3: Auf Home Assistant zugreifen

Öffne im Browser:

http://homeassistant.local:8123

Falls das nicht funktioniert, suche die IP-Adresse deines Pi im Router und öffne http://[IP]:8123.

Schritt 4: WLAN einrichten (falls kein Ethernet)

Wenn du kein Ethernet-Kabel nutzen kannst, musst du die WLAN-Daten vor dem ersten Boot auf die SD-Karte schreiben:

1. Stecke die SD-Karte in deinen PC
2. Öffne das Laufwerk hassos-boot
3. Erstelle eine Datei CONFIG/network/my-network mit folgendem Inhalt:

1[connection]
2id=my-network
3type=wifi
4
5[wifi]
6mode=infrastructure
7ssid=DeinWLANName
8
9[wifi-security]
10auth-alg=open
11key-mgmt=wpa-psk
12psk=DeinWLANPasswort
13
14[ipv4]
15method=auto
16
17[ipv6]
18method=auto

HA OS auf einem Mini-PC / Intel NUC installieren

Für mehr Leistung empfiehlt sich ein x86-Mini-PC:

1. Lade das HA OS Image für Generic x86-64 von der offiziellen Seite herunter
2. Flashe das Image mit Balena Etcher auf einen USB-Stick
3. Boote den Mini-PC vom USB-Stick
4. Das Image installiert sich auf die interne Festplatte/SSD
5. Nach dem Neustart: http://homeassistant.local:8123

Achtung: HA OS überschreibt die gesamte Festplatte! Nutze einen dedizierten PC oder installiere HA OS in einer virtuellen Maschine (Proxmox, VirtualBox).

HA OS in einer virtuellen Maschine (Proxmox)

Proxmox ist eine beliebte Virtualisierungsplattform. Damit kannst du HA OS neben anderen Diensten auf einem Server laufen lassen.

1. Lade das HA OS .qcow2-Image herunter
2. Erstelle in Proxmox eine neue VM (UEFI Boot, OVMF BIOS)
3. Weise 2 Cores, 4 GB RAM und 32 GB Disk zu
4. Importiere das Image als Disk
5. Starte die VM — HA OS bootet automatisch

1# Image herunterladen
2wget https://github.com/home-assistant/operating-system/releases/download/14.0/haos_ova-14.0.qcow2.xz
3
4# Entpacken
5xz -d haos_ova-14.0.qcow2.xz
6
7# In VM importieren (VM-ID anpassen!)
8qm importdisk 100 haos_ova-14.0.qcow2 local-lvm

Proxmox-Tipp: Für USB-Geräte (Zigbee-Stick, Bluetooth) musst du USB-Passthrough in den VM-Einstellungen konfigurieren. Unter "Hardware" → "Add" → "USB Device".

Docker-Installation (Container)

Für alle, die bereits einen Linux-Server oder ein NAS mit Docker haben:

1version: '3'
2services:
3  homeassistant:
4container_name: homeassistant
5image: ghcr.io/home-assistant/home-assistant:stable
6volumes:
7  - ./config:/config
8  - /etc/localtime:/etc/localtime:ro
9restart: unless-stopped
10privileged: true
11network_mode: host

Starte mit docker compose up -d und öffne dann http://[SERVER-IP]:8123.

Wichtig: Bei der Container-Installation hast du keine Add-ons. MQTT-Broker, Zigbee2MQTT und ähnliche Software musst du separat als Container installieren. Für Einsteiger empfehlen wir HA OS!

Supervised-Installation auf Debian

Die Supervised-Installation gibt dir die volle Kontrolle über das Betriebssystem und Zugriff auf Add-ons. Voraussetzungen: Debian 12 (Bookworm), Docker, NetworkManager, Systemd.

1# Voraussetzungen installieren
2sudo apt update && sudo apt install -y \
3  apparmor jq wget curl udisks2 \
4  libglib2.0-bin network-manager dbus \
5  lsb-release systemd-journal-remote
6
7# Docker installieren
8curl -fsSL https://get.docker.com | sh
9
10# OS Agent installieren
11wget https://github.com/home-assistant/os-agent/releases/latest/download/os-agent_linux_x86_64.deb
12sudo dpkg -i os-agent_linux_x86_64.deb
13
14# Supervised Installer ausführen
15wget https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb
16sudo dpkg -i homeassistant-supervised.deb

Core-Installation (Python venv)

Die "nackte" Installation für Python-Entwickler:

1# Python 3.12+ erforderlich
2sudo apt install -y python3 python3-dev python3-venv python3-pip \
3  bluez libffi-dev libssl-dev libjpeg-dev zlib1g-dev \
4  autoconf build-essential libopenjp2-7
5
6sudo useradd -rm homeassistant -d /srv/homeassistant
7sudo mkdir /srv/homeassistant
8sudo chown homeassistant:homeassistant /srv/homeassistant
9
10sudo -u homeassistant -H -s
11cd /srv/homeassistant
12python3 -m venv .
13source bin/activate
14pip install homeassistant
15hass

Nach der Installation: SSD statt SD-Karte

SD-Karten sind die häufigste Ursache für Probleme mit Home Assistant auf dem Raspberry Pi. Sie verschleissen schnell durch die vielen Schreibvorgaenge der Datenbank. Der Umstieg auf eine SSD ist der beste einzelne Verbesserungsschritt.

Vorteile einer SSD

• 5–10x schnellerer Start und schnellere Datenbankabfragen
• Deutlich laengere Lebensdauer (SSDs halten 10-100x mehr Schreibzyklen aus)
• Keine plötzlichen Ausfälle durch kaputte SD-Karten

Migration

1. Erstelle ein vollständiges Backup unter Einstellungen → System → Sicherungen
2. Flashe HA OS auf die SSD (gleicher Vorgang wie bei SD-Karte)
3. Boote vom SSD (Pi 4: USB-Boot aktivieren, Pi 5: automatisch)
4. Stelle das Backup wieder her

Häufige Installationsprobleme

Nächster Schritt: Nach dem ersten Zugriff startet der Onboarding-Assistent. Weiter zum Ersten Start