Trends Vandaag
Technologie

Complete gids 2025: Raspberry Pi OS Lite, Docker én Home Assistant

TV
Trends Vandaag
Redactie
Complete gids 2025: Raspberry Pi OS Lite, Docker én Home Assistant

Raspberry Pi OS Lite, Docker en Home Assistant installeren

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)

  1. Download Raspberry Pi Imager vanaf raspberrypi.com en start het programma.
  2. Klik op
    1. Choose OS →
    2. Raspberry Pi OS (Other) → 
    3. Raspberry Pi OS Lite (64‑bit).
  3. 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.
  4. Plaats een 16 GB + microSD of SSD in je computer, selecteer onder Storage en klik Write.
  5. 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:

bash
1ssh pi@raspberrypi.local # macOS / Linux
2# of
3ssh pi@<IP‑adres‑van‑de‑Pi>

Stap 3 – Pi up‑to‑date maken

bash
1sudo apt update && sudo apt upgrade -y
2sudo reboot

Stap 4 – Docker & Compose installeren

1. Verwijder eventuele oude Docker‑pakketten:

bash
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:

bash
1sudo apt-get install ca-certificates curl -y
2sudo install -m 0755 -d /etc/apt/keyrings
3curl -fsSL https://download.docker.com/linux/raspbian/gpg | sudo tee /etc/apt/keyrings/docker.asc
4printf "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.list
6sudo apt update
7sudo 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:

javascript
1sudo usermod -aG docker $USER

4. Test de installatie:

javascript
1docker run hello-world

Stap 5 – Map voor Home Assistant aanmaken

bash
1mkdir -p ~/homeassistant

Stap 6 – Home Assistant‑container starten

Snelle docker run

bash
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

bash
1services:
2 homeassistant:
3 image: ghcr.io/home-assistant/home-assistant:stable
4 container_name: homeassistant
5 privileged: true
6 network_mode: host
7 restart: unless-stopped
8 environment:
9 - TZ=Europe/Amsterdam
10 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:
bash
1docker pull ghcr.io/home-assistant/home-assistant:stable
2docker 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

  1. 32‑bit OS werkt, maar 64‑bit presteert beter.
  2. Rechten‑issues? Vergeet de docker‑groep niet.
  3. Poort 8123 bezet? Stop het andere proces of wijzig de poort.
  4. USB‑dongles (Zigbee): voeg --device /dev/ttyUSB0:/dev/ttyUSB0 toe.
  5. 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!