Fully fledged Python/Django based smart home automation platform built by professionals for professionals to be used in professional installations!

This repository represents SIMO.io main hub software that is responsible for every SIMO.io hub out there. There are two ways to start using this for your smart home project:

• Purchase physical SIMO.io hub from SIMO.io online shop which comes fully prepared and ready to power your smart home project immediately.

• Installing it on to a spare PC that you might already have.

For that you will need a PC or MiniPC which has at least 2 CPU cores, 4GB of RAM memory and 64GB of storage space.

You start by installing Ubuntu Server 24.*.* LTS on to it. If you have a disk that is at least 128 GB in size, please install it with LVM option leaving half of your LVM group unused, this allows for a best possible backup system using LVM snapshots and borg backup.

Once your home Ubuntu Server is up and running, you will have to use command line to log in to it. Next, become a root user by typing in:

sudo su root

Now comes the fun part. Type this command in and hope for the best:

wget https://simo.io/hubs/ubuntu-install?step=1 -O - | python3

This will download latest installation procedures from our man server and will try to install everything for you on your freshly created home Ubuntu Server.

If things go well, you should have your SIMO.io hub running in 10 to 20 minutes. However, if something goes wrong you can try to fix whatever was the problem and initiate the script from any later installation step you want by adjusting ...install?step=1 part of your instlal script initiation command.

Once you have your hub running in your local network you will need SIMO.io mobile app, which is available in Apple App Store and Google Play.

Sign up for an account if you do not have one yet, tap "Add New" and choose "Local". Fill few required details in and your SIMO.io smart home instance will be created in a moment.

From there you can start connecting The Game Changer boards (Colonels) and configuring your smart home components.

All of your SIMO.io instances are available in your personal Instances page, where you can access full Django Admin interface to each of them, from anywhere in the World!

Standard SIMO.io hub admin interface comes packed with various powerful features and an easy and convenient way to extend your hub with all kinds of extras.

For example, one of the amazing feature is that you can add your own public ssh key to your user account which automatically adds it to your hubs' /root/.ssh/authorized_keys which allows you to ssh in to it remotely from anywhere!

Your hub's Django project dir is found in /etc/SIMO/hub, this is where you find infamous manage.py file, edit settings.py file and add any additional Django apps that you might want to install or code on your own.

Processes are managed by supervisord, so you can do all kinds of things like:

• supervisorctl status all - to see how healthy are SIMO.io hub processes
• supervisorctl restart all - to restart SIMO.io hub processes
• supervisorctl stop simo-gunicorn - to stop SIMO.io simo-gunicorn processes
• supervisorctl start simo-gunicorn - to start SIMO.io simo-gunicorn processes

All of these processes are running as root user, because there is nothing more important on your SIMO.io hub than it's main software. That's by design and thoughtful intention.

Logs are piped to /var/log directory.

© Copyright by SIMO LT, UAB. Lithuania.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.