70 lines
2.0 KiB
Markdown
70 lines
2.0 KiB
Markdown
# Domoticz on SecuBox (Docker)
|
||
|
||
**Version:** 1.0.0
|
||
**Last Updated:** 2025-12-28
|
||
**Status:** Active
|
||
|
||
This guide documents the Domoticz (home automation) “app” packaged as `secubox-app-domoticz` plus its manifest-driven wizard entry.
|
||
|
||
---
|
||
|
||
## Installation
|
||
|
||
```sh
|
||
opkg update
|
||
opkg install secubox-app-domoticz luci-app-vhost-manager
|
||
/domoticzctl install
|
||
/etc/init.d/domoticz start
|
||
```
|
||
|
||
Then open **SecuBox → Wizard → App Wizards → Domoticz** to set data/devices paths or custom ports.
|
||
|
||
---
|
||
|
||
## UCI Config (`/etc/config/domoticz`)
|
||
|
||
```uci
|
||
config domoticz 'main'
|
||
option enabled '1'
|
||
option image 'domoticz/domoticz:latest'
|
||
option data_path '/srv/domoticz'
|
||
option devices_path '/srv/devices'
|
||
option port '8080'
|
||
option timezone 'UTC'
|
||
```
|
||
|
||
Adjust via `uci` or the wizard:
|
||
```sh
|
||
uci set domoticz.main.port='8181'
|
||
uci commit domoticz
|
||
/etc/init.d/domoticz restart
|
||
```
|
||
|
||
---
|
||
|
||
## CLI Helper (`/usr/sbin/domoticzctl`)
|
||
|
||
- `domoticzctl install` – checks Docker, prepares `/srv/domoticz`, pulls `domoticz/domoticz` image, enables service.
|
||
- `domoticzctl check` – rerun storage/cgroup/Docker validation.
|
||
- `domoticzctl update` – pull new image and restart if enabled.
|
||
- `domoticzctl status/logs` – interact with the Docker container.
|
||
|
||
---
|
||
|
||
## VHost & Profiles
|
||
|
||
- Use `scripts/vhostctl.sh add --domain ha.secubox.local --upstream http://127.0.0.1:<port>` to publish the web UI via HTTPS.
|
||
- The manifest tags Domoticz for the **Gateway + DMZ** profile, ensuring DMZ isolation by default.
|
||
|
||
---
|
||
|
||
## Troubleshooting
|
||
|
||
| Issue | Fix |
|
||
|-------|-----|
|
||
| Container fails to start | Check `/srv/domoticz/config` permissions; ensure Docker is running. |
|
||
| No devices under `/srv/devices` | Mount your serial/Zigbee USB adapter and bind-mount it into the container as needed. |
|
||
| LuCI wizard fields empty | Confirm manifest at `/usr/share/secubox/plugins/domoticz/manifest.json` and rerun SecuBox wizard. |
|
||
|
||
Domoticz now follows the same manifest-driven workflow as Lyrion/Zigbee2MQTT, paving the way for a full “SecuBox Apps Store.”
|