# Ozwdaemon

Ozwdaemon is a Docker container that runs the OpenZWave ozwdaemon service, bridging a Z-Wave controller to an MQTT (Message Queuing Telemetry Transport) broker so Home Assistant and other MQTT-compatible platforms can. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/102/ozwdaemon

## Description

Ozwdaemon is a Docker container that runs the OpenZWave ozwdaemon service, bridging a Z-Wave controller to an MQTT (Message Queuing Telemetry Transport) broker so Home Assistant and other MQTT-compatible platforms can manage Z-Wave devices.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

20/100 (Low), based on 3 of 4 factors.
- Maintained: 0 (last commit 2179 days ago)
- Popular: 41 (105 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Official website: https://www.home-assistant.io
- Documentation: https://www.home-assistant.io/integrations/ozw/
- GitHub: https://github.com/OpenZWave/qt-openzwave
- Docker Hub: https://hub.docker.com/r/openzwave/ozwdaemon/
- Unraid: https://ca.unraid.net/apps/ozwdaemon-1w2k1m40e6o9xc?q=ozwdaemon

## Common questions

### Where should I put persistent storage for ozwdaemon?

ozwdaemon uses /opt/ozw/config as the default location for cache files, device config files, logs, and crashdumps. Mount a persistent bind mount or named volume at that path.

### How do I connect the container to my MQTT broker and Z-Wave USB controller?

Set MQTT_SERVER, optional MQTT_PORT, MQTT_USERNAME, and MQTT_PASSWORD for the broker. Set USB_PATH to the container pathname of the mapped serial device, and it must match the device mapped into the container.

### Do I need to disable seccomp?

Use --security-opt seccomp=unconfined if you want meaningful backtraces and crashdump files. Without it, debugging ozwdaemon crashes can be difficult.

### Why might the ozwdaemon container stop unexpectedly?

The service shuts down under certain error conditions, such as being unable to connect to the MQTT broker. Set a restart policy, and use MQTT_CONNECT_TIMEOUT if you need more time for the broker to become available.

### How do I connect ozw-admin to a remote ozwdaemon?

Use the Remote OZWDaemon section of the Open dialog and specify the container host IP address and port 1983. The default ozw-admin port is 1983.

---
Source: Our Local Host (https://ourlocalhost.com/app/102/ozwdaemon), the self-hosted and open-source app directory.