e154/smart-home-server repository overview

⁠The Smart Home

Branch	Status
master
dev
docs

⁠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⁠
• Demo access⁠
• Supported system⁠
• Quick installation⁠
  • Postgresql⁠
• Docker⁠
• Support⁠
• Contributors⁠
• See also⁠
• 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
6. Organization of remote access without white IP FREE
7. Role system for separation of access rights
8. Plugin system
9. Programs in javaScript, coffeeScript, typeScript
10. Notification system SMS, Email, Slack, Telegram, Web push, html5
11. Embedded MQTT server/client/bridge
12. MODBUS, ZIGBEE2MQTT⁠, rpc calling, etc
13. Autonomous system.
14. Telegram bots
15. Automation scenarios
16. Quick backup/recovery
17. Have Docker images to enhance system security
18. Minimum consumption of resources.
19. Optimized for embedded devices like Raspberry Pi
20. 100% local home automation
21. Create and restore full backups of your whole configuration with ease
22. Management web interface integrated into Smart home

⁠Demo access

dashboard:
dashboard⁠ (https://gate.e154.ru:8443⁠)
dashboard⁠ (http://gate.e154.ru:8080⁠)

server id:
cf4463fc-2f39-4271-a034-5c0c8087c56c

user: [email protected]⁠
pass: admin

user: [email protected]⁠
pass: user

openapi v3 spec:
swagger⁠ (https://gate.e154.ru:8443/#/etc/swagger⁠)

⁠Supported system

• macOS 386 10.6
• macOS amd64 10.6
• linux 386
• linux amd64
• linux arm-6
• linux arm-7
• linux arm-64
• windows 386
• windows amd64

Schematic smart home map

⁠Database postgresql

Installing PostgreSQL 15⁠

⁠Editing configuration files

cp conf/config.dev.json conf/config.json

⁠Main server install

Download the latest server version from releases⁠

show help options

./server-linux-amd64 help

run the server

./server-linux-amd64

⁠Docker

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⁠ Bugs and feature requests: GitHub issues

⁠Contributors

• Alex Filippov⁠

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!

⁠LICENSE

GPLv3 Public License⁠