Zigbee2MQTT installeren op Proxmox en koppelen met Home Assistant

Zigbee2MQTT is een open-source softwareproject waarmee je Zigbee-apparaten (zoals Philips Hue, Ikea Tradfri en andere merken) kunt gebruiken met MQTT-gebaseerde home automation systemen, zoals Home Assistant en Node-RED. Zigbee2MQTT fungeert als brug tussen je Zigbee-apparaten en MQTT, waardoor je deze apparaten eenvoudig kunt bedienen en monitoren via je huisautomatiseringssysteem.

Je vindt de post-installatiegids hier: ProxmoxVE Community Scripts.

Wat heb je nodig?

Een Proxmox VE server
Een Zigbee USB-stick (zoals CC2531, CC26X2R1 of ConBee II)
Basiskennis van Linux en Proxmox
Home Assistant installatie (bij voorkeur op dezelfde Proxmox-server of bereikbaar via netwerk)

Stap 1: Nieuwe LXC-container maken voor Zigbee2MQTT

Zigbee2MQTT wordt het eenvoudigst geïnstalleerd in een LXC-container met de volgende eigenschappen:

Privileged: Ja
Updateable: Ja
Template: Alpine Linux
GitHub / Gitea beschikbaar: Ja

Gebruik het volgende commando in de Proxmox VE Shell om de container automatisch aan te maken en Zigbee2MQTT te installeren:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/zigbee2mqtt.sh)"

Dit script downloadt en installeert Zigbee2MQTT automatisch in een nieuwe Alpine Linux LXC-container.

Stap 2: Configuratiebestand vinden

Na installatie bevindt het configuratiebestand van Zigbee2MQTT zich op de volgende locatie:

/opt/zigbee2mqtt/data/configuration.yaml

Hier kun je belangrijke instellingen aanpassen, zoals:

MQTT-broker adres (bijvoorbeeld je Home Assistant MQTT-add-on)
Zigbee USB-stick poort (/dev/ttyUSB0 of /dev/ttyACM0)
Naam van je Zigbee netwerk
Device-specificatie en logniveau

Stap 3: Koppelen met Home Assistant

Installeer MQTT in Home Assistant
Ga naar Instellingen > Add-ons > Add-on Store en installeer de Mosquitto broker.
Start de add-on en noteer de gebruikersnaam en het wachtwoord.
Zigbee2MQTT configureren voor Home Assistant
Open configuration.yaml in de Zigbee2MQTT LXC en zorg dat de MQTT-instellingen correct zijn:

mqtt:
  base_topic: zigbee2mqtt
  server: 'mqtt://IP_VAN_HA:1883'
  user: 'mqtt_gebruiker'
  password: 'mqtt_wachtwoord'

homeassistant: true
permit_join: true

Restart Zigbee2MQTT
Na het opslaan van de wijzigingen, start je Zigbee2MQTT opnieuw:

sudo systemctl restart zigbee2mqtt

Voeg apparaten toe
Zet Zigbee2MQTT in permit_join: true modus en voeg je Zigbee-apparaten toe. Ze verschijnen automatisch in Home Assistant onder Integraties.

Stap 4: Controleren en beheren

Webinterface: Je kunt de Zigbee2MQTT webinterface openen via http://IP_VAN_LXC:8080 om apparaten te beheren.
Logboeken: Controleer /opt/zigbee2mqtt/data/log/zigbee2mqtt.log voor fouten of statusupdates.
Home Assistant: Apparaten worden automatisch herkend en kunnen direct gebruikt worden in automations en dashboards.

Tips

Gebruik altijd een stabiele USB-stick met goede Zigbee-antenne voor betrouwbare communicatie.
Houd permit_join uitgeschakeld wanneer je geen nieuwe apparaten toevoegt, om ongewenste apparaten te voorkomen.
Bewaar een backup van configuration.yaml voor je grote wijzigingen doorvoert.

Homeautomations