Getting started with Domoticz (2026.4): install, hardware and what it is good at

Discuss the Domoticz Home Automation Software
Post Reply
User avatar
ZerOne
Site Admin
Posts: 216
Joined: Sun Dec 13, 2020 8:21 am

Domoticz is a free, open source home automation system written in C++, with an HTML5 web UI that adapts to desktop and mobile. It has been around since 2012 and the project is still releasing: the 2026 stable releases so far are 2026.1, 2026.2, 2026.3 and 2026.4 (2026.4 was published on 1 October 2026 UTC). This thread is a starting point for newcomers.

Compiled from the Domoticz README, website and wiki as at October 2026. The "lightweight/stable" claims below come from the Domoticz site's own marketing and are not independent benchmarks. Corrections welcome.

1. What it is
  • Runs on Linux, Windows, macOS, FreeBSD and embedded boards such as the Raspberry Pi, and in Docker.
  • The Domoticz site claims it uses under 50 MB of RAM and can run on a Raspberry Pi Zero, and that everything runs locally with no cloud account needed.
  • Supports 150+ hardware types: Z-Wave, Zigbee, MQTT, RFXCOM, P1 smart meters, YouLess, 1-Wire, EnOcean, Philips Hue and more.
  • Automation via dzVents (Lua), Python plugins, Blockly and Lua scripts, plus time-based and device-triggered events.
  • Auto-learning switches/sensors, push notifications, extensive logging and sharing devices between instances.
2. Install options

Linux install script (per the wiki; the pre-built binaries require Ubuntu 24.04 LTS or newer on Ubuntu):

Code: Select all

sudo bash -c "$(curl -sSfL https://install.domoticz.com)"
The script runs a dialog asking about HTTP/HTTPS for the web UI and the ports. Then browse to http://<ip>:<port> (the wiki example uses 8080).

Docker: the official image is domoticz/domoticz, available for 64-bit Linux and 32/64-bit ARM. The wiki recommends the stable tag (there is also beta), docker compose for maintainability, and notes:
  • Persist the config folder as a volume (it holds the domoticz.db database and your scripts) and back it up before updating.
  • For USB dongles, map the device by its stable path, e.g. - "/dev/serial/by-id/usb-...:/dev/ttyUSB0".
  • Publish the ports you need: 8080 (HTTP), 443 (HTTPS) and 6144 (device sharing) if you use them.
  • Python plugins and dzVents work in the container, but see the wiki's Docker page for details on custom plugins.
Build from source or Windows/macOS: see the wiki (Linux, Docker) and the downloads page.

Serial permissions on Linux: if Domoticz runs as a non-root user and you use a USB stick (RFXCOM, etc.), add the user to the dialout group:

Code: Select all

sudo usermod -a -G dialout YOURUSERNAME
First login and security: the README says a setup wizard creates your admin account on first run, and that Docker deployments can use the DOMOTICZ_ADMIN_PASSWORD (and optional DOMOTICZ_ADMIN_USERNAME) environment variables. Older wiki pages mention a default admin/domoticz login for 2023.1+, so on a fresh install verify what yours does and change anything default immediately. There is a SECURITY_SETUP.md in the repo - read it.

3. Adding hardware

The basic workflow: Setup > Hardware, add a gateway/hardware type, then manage the discovered devices under Setup > Devices. The wiki's Hardware page is a community-curated list of devices and services (433 MHz via RFXCOM/RFLink, Z-Wave, Zigbee, Bluetooth, EnOcean, IP cameras, Modbus, solar inverters, EV chargers and more).

Modern protocol support is increasingly through MQTT:
  • Zigbee - through Zigbee2MQTT and the MQTT Auto Discovery Client Gateway (full walkthrough in the project thread).
  • Z-Wave - the wiki says Domoticz talks to Zwave-JS-UI over MQTT with Auto Discover; it is no longer integrated directly like the previous OpenZWave. There is a wiki page on migrating from OpenZWave.
  • Other devices that publish Home Assistant-style MQTT discovery messages (Tasmota can, when configured) can use the same gateway - check each device's docs.
  • Cameras - the wiki lists IP cameras by brand, including a method for grabbing snapshots from RTSP streams with an ffmpeg-based script. Domoticz is not an NVR; I'd pair it with a dedicated camera system. (There is no native ONVIF event integration that I know of - tell me if I'm wrong.)
4. Scripting

dzVents is the recommended way to write automation: Lua scripts that declare what triggers them (device changes, timers, variables, scenes, custom events, HTTP responses, shell command results, and so on) and an execute function. Python plugins add hardware support the core doesn't have.

5. Strengths and limitations (my view)
  • Strengths: light on resources, quick to get going, mature, very good for energy/P1 metering and classic sensors, dzVents is easy to learn.
  • Limitations: fewer integrations than Home Assistant or openHAB; UI feels dated to some people; newer protocols rely on MQTT bridges rather than native support; support is via the forum (the GitHub issue tracker is explicitly not for end-user support).
6. Links
Question: what do you use Domoticz for (energy metering, 433 MHz, Zigbee via MQTT, Z-Wave)? And if you have moved to or from Home Assistant, what did you gain and miss?
Post Reply

Return to “Domoticz Software Discussion”