Identity

Unit: zigbee2mqtt.service (systemd) or Docker container zigbee2mqtt
Config: /opt/zigbee2mqtt/data/configuration.yaml (bare metal) or ./data/configuration.yaml (Docker volume)
Logs: journalctl -u zigbee2mqtt -f (systemd) or docker logs -f zigbee2mqtt
Serial device: /dev/ttyUSB0, /dev/ttyACM0 — use /dev/serial/by-id/... for stability
Frontend: http://<host>:8080 (must be explicitly enabled in config)
Depends on: Mosquitto (or any MQTT broker) — must be running before Z2M starts
Install: Node.js service (git clone, npm ci) or docker run koenkk/zigbee2mqtt
User: typically pi, ubuntu, or a dedicated zigbee2mqtt user; must be in dialout group

Key Operations

Operation	Command
Check service status	`systemctl status zigbee2mqtt`
Follow logs live	`journalctl -u zigbee2mqtt -f`
Restart service	`sudo systemctl restart zigbee2mqtt`
Permit join (pair new device)	`mosquitto_pub -t zigbee2mqtt/bridge/request/permit_join -m '{"value": true, "time": 254}'`
Disable permit join	`mosquitto_pub -t zigbee2mqtt/bridge/request/permit_join -m '{"value": false}'`