Raspberry Setup

For both methods, the first thing you need to do is setup a Raspberry Pi.

Install Raspberry Pi Imager on your computer. Then, insert the SD card and run the Imager program. From the menu, select 64-bit Ubuntu Server as the operating system and ensure to select your SD card from the storage dropdown, and then press write.


Open the SD card's storage from your computer and navigate inside the root folder of the card. The name of the folder should be something similar to system-boot.

Find the file named network-config and open it in a text editor. Copy the below text and paste it into the file:

version: 2
    dhcp4: true
    optional: true
    dhcp4: true
    optional: true
        password: "YOUR_WIFI_PASSWORD"

Make sure that you input your actual wifi name and your wifi password. Then you need to save the file, and insert the SD card to the Raspberry Pi and turn it on. It must connect to your wi-fi network, now you need to find its address. Firstly find your address in the local network with:

ip a

It must look like 192.168.xx.xx or 172.xx.xx.xx.

Then scan the network with your address and zero in the end (also you can use arp -a):

$ sudo nmap -sP 192.168.xx.0/24
Starting Nmap 7.80 ( https://nmap.org ) at 2020-06-26 13:50 CEST
Nmap scan report for _gateway (
Host is up (0.015s latency).
MAC Address: 8E:F5:A3:DB:03:27 (Unknown)
Nmap scan report for ubuntu (
Host is up (0.049s latency).
MAC Address: DC:A6:32:02:46:50 (Raspberry Pi Trading)
Nmap scan report for LAPTOP-27UBLNO7 (
Host is up (0.00057s latency).
MAC Address: 7C:B2:7D:9E:95:DA (Intel Corporate)
Nmap scan report for ed-vm (
Host is up.
Nmap done: 256 IP addresses (4 hosts up) scanned in 2.07 seconds

In this example we can see that the Raspberry Pi's address is Now you can connect to it over ssh:

ssh ubuntu@

Password is "ubuntu".

Home Assistant

Now we need to install Home Assistant to the Raspberry Pi. Detailed instructions can be found here. You need to install Home Assistant Core. It's actual version is 2021.11.5 and instruction assumes that we already have installed Python 3.9 or newer.

Update your system and install necessary packages:

sudo apt-get update
sudo apt-get upgrade -y
sudo apt-get install -y python3 python3-dev python3-venv python3-pip libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential libopenjp2-7 libtiff5 tzdata libcurl4-openssl-dev

Create user homeassistant and the directory for homeassistant core:

sudo useradd -rm homeassistant
sudo mkdir /srv/homeassistant
sudo chown homeassistant:homeassistant /srv/homeassistant

Next up is to create and change to a virtual environment for Home Assistant Core. This will be done as the homeassistant account.

sudo -u homeassistant -H -s
cd /srv/homeassistant
python3.9 -m venv .
source bin/activate


Then install required Python packages:

python3 -m pip install wheel
pip3 install homeassistant==2021.11.5

Start Home Assistant Core for the first time. This will complete the installation for you, automatically creating the .homeassistantconfiguration directory in the /home/homeassistant directory, and installing any basic dependencies:

(homeassistant) homeassistant@ubuntu:/srv/homeassistant$ hass

You can now reach your installation via the web interface on http://%RASPBERRY_IP_ADDRESS%:8123. In this example:

You don't need to connect you raspberry to the screen, you can open Web UI from any computer connected to your local network

Create user and finish setup (first setup is described here in more details), then stop Home Assistant with Ctrl+C.

After this installation process has been completed, from the python_scripts folder import some necessary scripts:

mkdir python_scripts
cd python_scripts/
wget https://raw.githubusercontent.com/airalab/robonomics-smarthome/main/python_scripts/send_datalog.py
wget https://raw.githubusercontent.com/airalab/robonomics-smarthome/main/python_scripts/control.py
wget https://raw.githubusercontent.com/airalab/robonomics-smarthome/main/python_scripts/utils.py
wget https://raw.githubusercontent.com/airalab/robonomics-smarthome/main/python_scripts/create_config.py
wget https://raw.githubusercontent.com/airalab/robonomics-smarthome/main/python_scripts/decrypt.py
wget https://raw.githubusercontent.com/airalab/robonomics-smarthome/main/python_scripts/encrypt.py

To use Robonomics you need account (instructions of how to create it are here). Add mnemonic or raw seed from it in config.config file:

nano /srv/homeassistant/python_scripts/config.config

In this format:

SEED = <your mnemonic or raw seed>

Substrate Interface

To pub data to Robonomics you need to install substrate-interface python package (you need to install RUST before) to your raspberry.

Install RUST:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env
rustup default nightly

And install necessary python packages to the virtual environment:

pip3 install pynacl==1.4.0 packaging pycurl
pip3 install substrate-interface==1.1.2 --use-feature=2020-resolver
pip3 install python-miio==0.5.8 --use-feature=2020-resolver

Be sure that you-re on virtual environment:


Systemd services

Now change user (you can run under any user, which allows you to use sudo):

(homeassistant) homeassistant@ubuntu:/srv/homeassistant/python_scripts$ exit

Create new service for home assistant start:

ubuntu@ubuntu:~$ sudo nano /etc/systemd/system/home-assistant@homeassistant.service 

Paste the following:

Description=Home Assistant
ExecStart=/srv/homeassistant/bin/hass -c "/home/%i/.homeassistant"


Do the same for robonomics control service:

ubuntu@ubuntu:~$ sudo nano /etc/systemd/system/robonomics-control@homeassistant.service 


Description=Robonomics Control
ExecStart=/srv/homeassistant/bin/python3.9 "/srv/%i/python_scripts/control.py"


And enable both services:

ubuntu@ubuntu:~$ sudo systemctl enable home-assistant@homeassistant.service
ubuntu@ubuntu:~$ sudo systemctl enable robonomics-control@homeassistant.service

After that you can connect your devices:

← Overview Raspberry Setup with Prepared Image →