Why this Configuration?
- True Data Sovereignty: 100% GDPR-compliant on-premises deployment. You own your configuration and data without vendor lock-in.
- Hardware Agnostic: Optimized and verified across low-power ARM64 SBCs (Raspberry Pi 5) and x86_64 hypervisors (Proxmox VE LXC & VM).
- Engine Freedom: Tested and supported under standard Docker Engine and unprivileged rootless Podman.
Quick Start (Standalone Docker Compose)
The snippet below is immediately ready to run in any standard Docker or Podman environment:
services:
zigbee2mqtt:
container_name: njorddeploy-zigbee2mqtt
image: koenkk/zigbee2mqtt:latest
restart: unless-stopped
volumes:
- "./data/zigbee2mqtt:/app/data"
- /run/udev:/run/udev:ro
ports:
- "8080:8080"
environment:
- "PUID=1000"
- "PGID=1000"
- "TZ=Europe/Amsterdam"
- "ZIGBEE2MQTT_CONFIG_MQTT_SERVER=mqtt://mosquitto:1883"
- "ZIGBEE2MQTT_CONFIG_FRONTEND=true"
- "ZIGBEE2MQTT_CONFIG_FRONTEND_PORT=8080"
- "ZIGBEE2MQTT_CONFIG_FRONTEND_HOST=0.0.0.0"
- "ZIGBEE2MQTT_CONFIG_SERIAL_PORT=/dev/ttyUSB0"
devices:
- "/dev/ttyUSB0:/dev/ttyUSB0"
networks:
- njorddeploy_net
networks:
njorddeploy_net:
Start the service directly via the command line: docker compose up -d
Configuration & Environment Variables
Key configuration parameters and defaults derived from the NjordDeploy component template:
| Variable | Default Value | Description |
|---|---|---|
|
8080 |
The port to access the Zigbee2MQTT web interface. |
|
/dev/ttyUSB0 |
Path to your Zigbee USB adapter (e.g. /dev/ttyUSB0). |
|
True |
Set to 'true' to mount a physical USB adapter, or 'false' for network-based Zigbee coordinators (TCP). |
Ecosystem & Enterprise Integration
- Reverse Proxy Ingress Ready: Pre-configured for Caddy, Traefik, or Nginx Proxy Manager with automatic Let's Encrypt TLS certificates.
- Zero-Trust Mesh VPN: Seamless integration with WireGuard or Tailscale/Headscale mesh networks for secure remote administration.
- Transactional State Backups: Ready for point-in-time database dumps and container-safe persistent volume freezing.
Effortless Management with NjordDeploy
Deploy, monitor, and update this service with a single click on your own hardware via the NjordDeploy Configurator.