# Domoticz

> Domoticz is a free, open source home automation system that monitors and controls smart home devices including lights, switches, sensors, and meters. It runs on Linux, Windows, macOS, Raspberry Pi, Docker, and Synology NAS. Domoticz supports 150+ hardware types including Z-Wave, Zigbee, MQTT, Philips Hue, 1-Wire, EnOcean, and RFXCOM. It features a responsive HTML5 web dashboard, powerful automation scripting (dzVents/Lua, Python, Blockly), energy monitoring, push notifications, and a fully local privacy-first architecture with no cloud dependency required.

## Project Info

- License: GPLv3
- Language: C++ backend, AngularJS frontend
- Default port: 8080
- Default credentials: admin / domoticz
- Source code: https://github.com/domoticz/domoticz
- Website: https://www.domoticz.com
- Forum: https://forum.domoticz.com
- Wiki: https://wiki.domoticz.com

## Getting Started

- [Getting Started Guide](https://wiki.domoticz.com/Getting_started): First steps after installing Domoticz
- [Raspberry Pi Installation](https://wiki.domoticz.com/Raspberry_Pi): Install on Raspberry Pi (most popular platform)
- [Linux Installation](https://wiki.domoticz.com/Linux): Install on Linux distributions
- [Windows Installation](https://wiki.domoticz.com/Windows): Install on Windows
- [Docker Installation](https://wiki.domoticz.com/Docker): Run Domoticz in Docker
- [Synology NAS Installation](https://wiki.domoticz.com/Synology): Install on Synology NAS
- [Downloads](https://www.domoticz.com/downloads/): Latest release downloads

## Configuration & Setup

- [Configuration](https://wiki.domoticz.com/Configuration): General system configuration
- [Hardware Setup](https://wiki.domoticz.com/Hardware): Adding and configuring hardware controllers
- [Managing Devices](https://wiki.domoticz.com/Managing_Devices): Adding, editing, and organizing devices
- [Customization](https://wiki.domoticz.com/Customization): Customizing the Domoticz interface
- [Compatible Products](https://wiki.domoticz.com/Compatible_products): List of compatible smart home devices

## Scripting & Automation

- [Scripting Overview](https://wiki.domoticz.com/Scripting_in_Domoticz): All scripting options in Domoticz
- [dzVents Lua Scripting](https://wiki.domoticz.com/DzVents:_next_generation_Lua_scripting): Recommended scripting engine using Lua
- [Blockly Visual Scripting](https://wiki.domoticz.com/Blockly): Visual drag-and-drop automation builder
- [Automation](https://wiki.domoticz.com/Automation): Event-based automation and timers

## API & Integration

- [JSON API Reference](https://wiki.domoticz.com/Domoticz_API/JSON_URL%27s): Complete API documentation for /json.htm endpoints
- [MQTT](https://wiki.domoticz.com/MQTT): MQTT integration for IoT messaging
- [Integrations and Protocols](https://wiki.domoticz.com/Integrations_and_Protocols): Supported protocols and third-party integrations

## Supported Hardware

Domoticz supports 150+ hardware types. Key categories include:

- **Wireless protocols**: Z-Wave, Zigbee, RFXCOM (433MHz), EnOcean, Bluetooth
- **Smart lighting**: Philips Hue, IKEA Tradfri, Yeelight
- **Energy monitoring**: P1 Smart Meter, YouLess, Pulse Counters, SolarEdge
- **MQTT devices**: Any MQTT-compatible sensor or actuator
- **Weather**: OpenWeatherMap, Buienradar, Weather Underground
- **IP cameras**: ONVIF, generic MJPEG/RTSP streams
- **GPIO**: Raspberry Pi GPIO for direct sensor/relay control
- **1-Wire**: DS18B20 temperature sensors and more
- **Custom**: Python plugin system for adding any hardware

## Help & Support

- [FAQ](https://wiki.domoticz.com/Frequently_Asked_Questions): Frequently asked questions
- [Troubleshooting](https://wiki.domoticz.com/Troubleshooting): Common issues and solutions
- [Community Forum](https://forum.domoticz.com): 16,000+ members, 216,000+ posts
- [Plugin Development](https://wiki.domoticz.com/Developing_a_hardware_plugin): Guide for developing hardware plugins in Python