Documentation

Complete guide to deploying and using Domotic AI.

Getting Started

Domotic AI is a comprehensive home automation system designed to manage multiple houses with seamless integration for Zigbee2MQTT.

Prerequisites

  • Docker & Docker Compose
  • Git
  • A Zigbee USB Dongle (optional, for Zigbee support)

Quick Deployment

# 1. Clone the repository

git clone https://github.com/adriandy89/domotic-ai.git

# 2. Setup environment

cp .env.example .env

# 3. Deploy automatically

./deploy-batched.sh

Architecture Stacks

Stack Docker

Core infrastructure services.

  • • TimescaleDB (PostgreSQL)
  • • Redis Cache
  • • NATS Messaging

Stack TBMQ

ThingsBoard MQTT Broker infrastructure.

  • • TBMQ Broker
  • • Kafka
  • • Zookeeper

Stack Client

Edge/Client side services.

  • • Zigbee2MQTT
  • • Portainer (Optional)
  • • Cloudflare Tunnel (Optional)

Backend

Main application logic.

  • • NestJS Microservices
  • • Prisma ORM
  • • API Gateway

Troubleshooting

Zigbee Dongle Not Detected

Ensure your user has permissions to access the serial device. Run:

sudo usermod -aG dialout $USER

Services not starting

Check logs for the specific stack. For example:

docker compose logs -f