Home Assistant installieren

Welche Methode ist die richtige?

Home Assistant kann auf verschiedene Arten installiert werden. Falls du noch nicht weißt, was Home Assistant ist, schau dir zuerst den Guide Was ist Home Assistant? an. 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. Mein Favorit für die meisten Setups: Ein gebrauchter Büro-Mini-PC schlägt den Raspberry Pi bei Preis, Leistung und Zuverlässigkeit. Bewährte Modelle sind Lenovo ThinkCentre Tiny, Dell OptiPlex Micro und HP EliteDesk Mini, alle ab etwa 80 € gebraucht. Auch die beliebten Intel-N100-Geräte ab ~130 € neu sind eine gute Wahl, sparsam mit 6 bis 10 Watt im Betrieb.

So läuft die Installation:

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. BIOS vorbereiten: Beim Start ins BIOS (meist F2 oder Entf): Secure Boot ausschalten, UEFI-Boot aktivieren und unter den Power-Optionen „Restore on AC Power Loss" auf „Power On" stellen. Damit startet der Server nach einem Stromausfall von selbst wieder
4. Boote den Mini-PC vom USB-Stick (Boot-Menü meist F7, F11 oder F12)
5. Das Image installiert sich automatisch auf die interne Festplatte/SSD, danach herunterfahren und Stick abziehen
6. 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).

Häufiger Stolperstein: Wenn der Mini-PC nach der Installation wieder den Installer startet, bootet er noch vom USB-Stick. Stick abziehen oder im BIOS die interne SSD an die erste Stelle der Boot-Reihenfolge setzen.

Und auf einem Windows-PC? Dauerhaft Home Assistant auf dem Windows-Rechner laufen zu lassen, funktioniert nur als virtuelle Maschine (z.B. VirtualBox) und taugt eher zum Ausprobieren: Der PC muss dafür rund um die Uhr an bleiben. Für den Dauerbetrieb ist ein eigener Mini-PC die deutlich bessere Lösung, auch beim Stromverbrauch.

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. Die komplette Anleitung vom Boot-Stick bis zum USB-Passthrough steht im eigenen Proxmox-Guide, hier die Kurzfassung:

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:
4    container_name: homeassistant
5    image: ghcr.io/home-assistant/home-assistant:stable
6    volumes:
7      - ./config:/config
8      - /etc/localtime:/etc/localtime:ro
9    restart: unless-stopped
10    privileged: true
11    network_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 empfehle ich 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 verschleißen schnell durch die vielen Schreibvorgänge der Datenbank. Der Umstieg auf eine SSD ist der beste einzelne Verbesserungsschritt.

Vorteile einer SSD

• 5–10x schnellerer Start und schnellere Datenbankabfragen
• Deutlich längere 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

Häufige Fragen

Welche Installationsmethode ist die beste für Einsteiger?

Home Assistant OS auf einem dedizierten Gerät, also Green, Raspberry Pi oder Mini-PC. Nur damit bekommst du Add-ons, automatische Updates und Backups ohne Handarbeit. Docker und Core sind was für Leute, die bewusst darauf verzichten wollen.

Kann ich Home Assistant auf meinem normalen PC installieren?

Zum Testen ja, als virtuelle Maschine mit VirtualBox. Für den Dauerbetrieb taugt das nicht, weil der PC durchgehend laufen müsste. Ein Mini-PC für 80 € braucht 6 Watt statt 100 und läuft einfach immer.

Wie lange dauert die Installation?

Vom Image-Download bis zum Onboarding-Bildschirm etwa 20 bis 30 Minuten, davon ist das meiste Wartezeit beim Flashen und ersten Start. Die eigentliche Arbeit sind fünf Minuten.

Raspberry Pi oder Mini-PC?

Der Pi reicht für den Einstieg und kleine Setups. Sobald Kamerastreams, viele Integrationen oder Datenbank-Auswertungen dazukommen, ist ein gebrauchter Mini-PC die bessere Wahl: mehr Leistung, SSD statt SD-Karte, oft sogar günstiger.

Brauche ich einen Bildschirm am Home-Assistant-Gerät?

Nur kurz bei der Mini-PC-Installation fürs BIOS. Danach läuft alles über den Browser. Pi und Green brauchen nie einen Bildschirm.

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

Weiter lesen:

• Erster Start: Onboarding Schritt für Schritt
• Häufige Probleme lösen