https://github.com/e154/smart-home
software package for automation
https://github.com/e154/smart-home
dashboard go golang home-automation modbus mqtt orangepi raspberry-pi scada smart-home smarthome stupid-home zigbee zigbee2mqtt
Last synced: 17 days ago
JSON representation
software package for automation
- Host: GitHub
- URL: https://github.com/e154/smart-home
- Owner: e154
- License: gpl-3.0
- Created: 2017-01-10T13:56:39.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2025-11-30T10:50:52.000Z (2 months ago)
- Last Synced: 2025-11-30T11:31:13.254Z (2 months ago)
- Topics: dashboard, go, golang, home-automation, modbus, mqtt, orangepi, raspberry-pi, scada, smart-home, smarthome, stupid-home, zigbee, zigbee2mqtt
- Language: Go
- Homepage: http://e154.github.io/smart-home/
- Size: 74.2 MB
- Stars: 96
- Watchers: 9
- Forks: 13
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-go-cn - smart-home - home) (物联网 / 检索及分析资料库)
- awesome-go-with-stars - smart-home - 11-30 | (IoT (Internet of Things) / Search and Analytic Databases)
- awesome-go - e154/smart-home
- fucking-awesome-go - smart-home - Software package for IoT automation. (IoT (Internet of Things) / Search and Analytic Databases)
- awesome-go-plus - smart-home - Software package for IoT automation.  (IoT (Internet of Things) / Search and Analytic Databases)
- awesome-ccamel - e154/smart-home - software package for automation (Go)
- awesome-go - smart-home - Software package for IoT automation. (IoT (Internet of Things) / Search and Analytic Databases)
- awesome-go - smart-home - Software package for IoT automation. (IoT (Internet of Things) / Search and Analytic Databases)
README
# The **Smart Home**
[](https://goreportcard.com/report/github.com/e154/smart-home)
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://t.me/SmartHomGo)
| Branch | Status |
|--------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|
| master | [](https://github.com/e154/smart-home/actions/workflows/build.yml) |
| dev | [](https://github.com/e154/smart-home/actions/workflows/test.yml) |
| docs | [](https://github.com/e154/smart-home/actions/workflows/docs.yml) |
### Overview
With the help of the software package **Smart Home** you can control many devices. Distributed network of devices based
on software package **Smart Home** has no geographical boundaries and allows manage devices anywhere in the Internet
through a system of nodes - microservices. You will be able to interact with these devices as if they were on your local
network. Create scripts and reactions to events in the web interface of the configurator through a flexible scripting
system.
The system does not require a permanent connection to the Internet, it is completely autonomous and has no dependencies
on external services.
The basic principles underlying the system being developed are ease of setup, low cost of content and accessibility of
the component base.
- [Features](#features)
- [Demo access](#demo-access)
- [Supported system](#supported-system)
- [Quick installation](#quick-installation)
- [Postgresql](#database-postgresql)
- [Docker](#docker)
- [Support](#support)
- [Contributors](#contributors)
- [See also](#see-also)
- [License](#license)
### Features
1. The ultimate smart thing solution - server, configurator, gateway
2. Free and open source
3. Cross-platform Linux, MacOS, Windows ...
4. Convenient WEB-configurator for fine-tuning
5. Powerful visual interface editor
5. Organization of remote access without white IP FREE
6. Role system for separation of access rights
7. Plugin system
7. Programs in javaScript, coffeeScript, typeScript
8. Notification system SMS, Email, Slack, Telegram, Web push, html5
9. Embedded MQTT server/client/bridge
9. MODBUS, [ZIGBEE2MQTT](https://www.zigbee2mqtt.io/), rpc calling, etc
10. Autonomous system.
11. Telegram bots
11. Automation scenarios
11. Quick backup/recovery
12. Have Docker images to enhance system security
13. Minimum consumption of resources.
14. Optimized for embedded devices like Raspberry Pi
15. 100% local home automation
16. Create and restore full backups of your whole configuration with ease
17. Management web interface integrated into Smart home
### Demo access
dashboard:
[dashboard](https://gate.e154.ru:8443) (https://gate.e154.ru:8443)
[dashboard](http://gate.e154.ru:8080) (http://gate.e154.ru:8080)
server id:
**cf4463fc-2f39-4271-a034-5c0c8087c56c**
user: admin@e154.ru
pass: admin
user: user@e154.ru
pass: user
openapi v3 spec:
[swagger](https://gate.e154.ru:8443/#/etc/swagger) (https://gate.e154.ru:8443/#/etc/swagger)
### Supported system
* macOS 386 10.6
* macOS amd64 10.6
* linux 386
* linux amd64
* linux arm-5
* linux arm-6
* linux arm-7
* linux arm-64
* linux mips64
* linux mips64le
* windows 386
* windows amd64
Schematic smart home map
### Database postgresql
[Installing PostgreSQL 15](https://e154.github.io/smart-home/docs/install/postgresql/)
### Editing configuration files
```bash
cp conf/config.dev.json conf/config.json
```
### Main server install
Download the latest server version from [releases](https://github.com/e154/smart-home/releases)
show help options
```bash
./server-linux-amd64 help
```
run the server
```bash
./server-linux-amd64
```
### Docker
```bash
git clone https://github.com/e154/smart-home
cd smart-home
docker-compose up
```
It's all
### Support
Smart home Wiki: [e154.github.io/smart-home](https://e154.github.io/smart-home/)
Bugs and feature requests: GitHub issues
### Contributors
- [Alex Filippov](https://github.com/e154)
All the contributors are welcome. If you would like to be the contributor please accept some rules.
- The pull requests will be accepted only in "develop" branch
- All modifications or additions should be tested
Thank you for your understanding!
### Star History
### LICENSE
[GPLv3 Public License](https://github.com/e154/smart-home/blob/master/LICENSE)