Slimme huizen zijn hotter dan ooit. Home Assistant telt inmiddels 2 miljoen actieve installaties wereldwijd. Met een betaalbare Raspberry Pi, het lichte Raspberry Pi OS Lite en Docker zet je in een middag je eigen smart‑homehub neer. Deze gids neemt je stap‑voor‑stap mee.
Wat is Docker & waarom op een Raspberry Pi?
Docker verpakt software in geïsoleerde containers. Daardoor blijft Home Assistant los van het besturingssysteem, kun je snel updaten en heb je minder kans op configuratie‑conflicten. Ideaal voor de bescheiden hardware van een Pi.
Benodigdheden
- Raspberry Pi 3, 4 of 5 (liefst 4 GB RAM of meer).
- 64‑bit Raspberry Pi OS Lite (Bookworm).
- MicroSD/SSD 16 GB + en een stabiele voeding.
- Een terminal/SSH‑verbinding.
Stap 1 – Raspberry Pi OS Lite installeren (headless)
- Download Raspberry Pi Imager vanaf raspberrypi.com en start het programma.
- Klik op
- Choose OS →
- Raspberry Pi OS (Other) →
- Raspberry Pi OS Lite (64‑bit).
- Druk op Ctrl + Shift + X voor Advanced Options:
- Hostname:
raspberrypi
(of eigen keuze). - Enable SSH: vink aan of kies Use password authentication.
- Set username/password (standaard
pi
). - Configure Wi‑Fi (optioneel): SSID, wachtwoord en land.
- Hostname:
- Plaats een 16 GB + microSD of SSD in je computer, selecteer onder Storage en klik Write.
- Na het schrijven plaats je de kaart in de Pi, sluit voeding en netwerk aan. Het OS boot nu headless.
Stap 2 - Inloggen via SSH
Wacht ±60 seconden, open dan een terminal op je pc:
1ssh pi@raspberrypi.local # macOS / Linux2# of3ssh pi@<IP‑adres‑van‑de‑Pi>
Stap 3 – Pi up‑to‑date maken
1sudo apt update && sudo apt upgrade -y2sudo reboot
Stap 4 – Docker & Compose installeren
1. Verwijder eventuele oude Docker‑pakketten:
1for pkg in docker.io docker-doc docker-compose podman-docker containerd runc; do sudo apt-get remove $pkg; done
2. Voeg de officiële Docker‑repository toe en installeer Docker Engine + Compose‑plugin:
1sudo apt-get install ca-certificates curl -y2sudo install -m 0755 -d /etc/apt/keyrings3curl -fsSL https://download.docker.com/linux/raspbian/gpg | sudo tee /etc/apt/keyrings/docker.asc4printf "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/raspbian $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \5 sudo tee /etc/apt/sources.list.d/docker.list6sudo apt update7sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y
3. Optioneel: voeg je gebruiker toe aan de groep docker
en log opnieuw in:
1sudo usermod -aG docker $USER
4. Test de installatie:
1docker run hello-world
Stap 5 – Map voor Home Assistant aanmaken
1mkdir -p ~/homeassistant
Stap 6 – Home Assistant‑container starten
Snelle docker run
1docker run -d --name homeassistant --privileged \2 --restart=unless-stopped -e TZ=Europe/Amsterdam \3 -v ~/homeassistant:/config \4 --network=host ghcr.io/home-assistant/home-assistant:stable
Of met Docker Compose
1services:2 homeassistant:3 image: ghcr.io/home-assistant/home-assistant:stable4 container_name: homeassistant5 privileged: true6 network_mode: host7 restart: unless-stopped8 environment:9 - TZ=Europe/Amsterdam10 volumes:11 - ./homeassistant:/config
Start met docker compose up -d
.
Eerste keer inloggen
Open http://raspberrypi.local:8123 (of het IP‑adres). Doorloop de onboarding: account, taal, integraties. Binnen enkele minuten zie je je eerste dashboard.
Bijwerken & onderhoud
- Wekelijks updaten:
1docker pull ghcr.io/home-assistant/home-assistant:stable2docker restart homeassistant
- Automatisch: installeer Watchtower of voeg
docker compose pull && docker compose up -d
toe aan een cronjob. - Maak back‑ups via Instellingen → Systeem → Back‑ups.
Veelgemaakte fouten & tips
- 32‑bit OS werkt, maar 64‑bit presteert beter.
- Rechten‑issues? Vergeet de
docker
‑groep niet. - Poort 8123 bezet? Stop het andere proces of wijzig de poort.
- USB‑dongles (Zigbee): voeg
--device /dev/ttyUSB0:/dev/ttyUSB0
toe. - Langzame SD‑kaart? Gebruik een SSD voor snellere IO.
Snelle samenvatting
- Flash Raspberry Pi OS Lite met SSH aan.
- Log in via
ssh pi@raspberrypi.local
. - Installeer Docker uit de officiële repo.
- Maak map
~/homeassistant
. - Start Home Assistant en bezoek <IP‑adres‑van‑de‑Pi>:8123.
Conclusie
Je hebt nu een volledig werkende Home Assistant‑installatie in Docker op een slanke Raspberry Pi. Updates zijn één command, back‑ups zijn eenvoudig en je config blijft veilig gescheiden.
What’s next?
Bouw door: voeg Zigbee2MQTT toe voor draadloze sensoren, gebruik Node‑RED voor visuele automatisering of experimenteer met de aankomende Matter‑integratie in Home Assistant 2025.6. Blijf TrendsVandaag.nl volgen voor de laatste smart‑home‑trends — jouw huis wordt elke update slimmer!