Gladys Assistant

A privacy-first, open-source home automation platform. Gladys runs with an embedded SQLite database and provides a modern dashboard for managing smart home devices, scenes, and automations.

First-Time Setup

1. Visit your domain — you will be guided through creating your admin account
2. Configure your home — set up rooms and floors in the dashboard
3. Add integrations — connect smart devices via MQTT, Zigbee2MQTT, Z-Wave, Philips Hue, Tasmota, and more
4. Create scenes — automate your home with triggers, conditions, and actions
5. Set up the dashboard — customize widgets to monitor temperature, humidity, camera feeds, and device states

Key Features

• Privacy-first — runs locally, no cloud dependency
• Embedded SQLite database — no external database needed
• Modern, responsive dashboard
• 30+ integrations (MQTT, Zigbee2MQTT, Z-Wave, Philips Hue, Tasmota, Google Cast, etc.)
• Scene engine with triggers, conditions, and actions
• Multi-user support with fine-grained permissions
• Camera integration and live feeds
• Calendar and alarm clock features
• Telegram and other notification services

Configuration

• TZ — timezone for the server (default: UTC)
• SQLITE_FILE_PATH — database file location (pre-configured to persist in the data volume)
• SERVER_PORT — web server port (default: 80)

Data Storage

All data is stored in the /var/lib/gladysassistant volume, including the SQLite database file and device configuration.

License

Apache-2.0 — GitHub | Website