OpenBSD Handbook

OpenBSD 7.9 release · amd64 · Generated 2026-09-16

zigbee2mqtt-2.9.2

Zigbee to MQTT bridge

Project homepage: https://www.zigbee2mqtt.io/

Description

zigbee2mqtt allows you to use your Zigbee devices without the vendor's bridge or gateway. It bridges events and allows you to control your Zigbee devices via MQTT. In this way you can integrate your Zigbee devices with whatever smart home infrastructure you are using. To use it, you will need suitable Zigbee bridge hardware (typically USB-based), Zigbee devices, and an MQTT server (for example, mosquitto or rabbitmq). zigbee2mqtt has mature support for adapters based on TI zStack, SiLabs EmberZNet, and Dresden Elektronik deCONZ. It has experimental support for some others. Most of these are USB devices presenting as a serial UART (/dev/cuaU*) when running the correct firmware - it has some support for network-based (wifi/ethernet) devices.

Package information

Ports path
comms/zigbee2mqtt
Package architecture
amd64
Maintainer
Stuart Henderson <stu.ports@spacehopper.org>
Categories
comms
Available flavors
None listed
Only for architectures
amd64, aarch64

These are ports metadata. Binary availability depends on the release, architecture and mirror. Build and test dependencies are not an installation checklist.

Direct dependencies

Runtime

Build

OpenBSD README

This README contains unresolved ports variables. It is source documentation; commands containing these variables require adjustment.

+-----------------------------------------------------------------------
| Running zigbee2mqtt on OpenBSD
+-----------------------------------------------------------------------

You will need to use a suitable hardware device to interface with
Zigbee, and that device will often need to have specific firmware
loaded before it can be used. Refer to upstream documentation for
more information.

Device permissions
------------------
zigbee2mqtt uses USB devices which present themselves as serial ports
(/dev/cuaU0 if this is the only USB serial device on the system).

The user running the daemon (normally _z2m) must have access to the
relevant serial port device nodes. zigbee2mqtt will not start unless
either this is done, or configuration is changed to use a network-
based device.

Either edit /etc/group and add _z2m to "dialer", or if you would like
to restrict it to a specific device, change the group ownership of
the relevant /dev/cuaU* device to _z2m.

The default configuration installed by the package starts a front-end
on http://127.0.0.1:8080/ - edit ${SYSCONFDIR}/zigbee2mqtt/configuration.yaml
to change or disable this.

Package guides

Package details as JSON