Homeautomations

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

  1. 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.
  2. 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
  1. Restart Zigbee2MQTT
    Na het opslaan van de wijzigingen, start je Zigbee2MQTT opnieuw:
sudo systemctl restart zigbee2mqtt
  1. 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.

admin

, , , , , , , ,