zigbee2mqtt/docs/information/docker.md

Docker

It is possible to run Zigbee2mqtt in a Docker container using the official Zigbee2mqtt Docker image.

First run the container, this will create the configuration directory. Change configuration.yaml according to your situation and start again.

Parameters

• -v $(pwd)/data:/app/data: Directory where Zigbee2mqtt stores it configuration
• --device=/dev/ttyACM0: Location of CC2531 USB sniffer

Supported architectures

amd64

docker run \
   -it \
   -v $(pwd)/data:/app/data \
   --device=/dev/ttyACM0 \
   koenkk/zigbee2mqtt

arm32v6 (E.G. Raspberry Pi)

docker run \
   -it \
   -v $(pwd)/data:/app/data \
   --device=/dev/ttyACM0 \
   koenkk/zigbee2mqtt:arm32v6

arm64v8

docker run \
   -it \
   -v $(pwd)/data:/app/data \
   --device=/dev/ttyACM0 \
   koenkk/zigbee2mqtt:arm64v8

Updating

To update to the latest Docker image:

docker rm -f [ZIGBEE2MQTT_CONTAINER_NAME]
docker rmi -f [ZIGBEE2MQTT_IMAGE_NAME] # e.g. koenkk/zigbee2mqtt:arm32v6
# Now run the container again, Docker will automatically pull the latest image.

Tags

The following tags are available:

• Latest release version: latest, arm32v6, arm64v8
• Latest dev version (based on dev branch): latest-dev, arm32v6-dev, arm64v8-dev
• Locked to a specific release version: X.X.X (e.g. 0.2.0), X.X.X-arm32v6 (e.g. 0.2.0-arm32v6), X.X.X-arm64v8 (e.g. 0.2.0-arm64v8)