Installation guide
Evok can be installed on Unipi OS or RaspberryPi OS. To install Evok, you will have to prepare the OS and then install the package.
OS preparation
This step varies by the platform used, either Unipi images or RaspberryPi OS.
Pre-built Unipi OS images
The latest images for Unipi controllers, including those with Evok pre-installed, can be downloaded from the Unipi Technology Knowledge Base.
All necessary APT Unipi repositories are already preconfigured in the OS images. Therefore, all that's required is to login to the controller via SSH. The default username for our images is "unipi" and the default password is "unipi.technology".
You can proceed to Installing and updating Evok section.
RaspberryPi OS
In order to install Evok on Neuron/Unipi1.X with RaspberryPi OS, you will need an SD card with a standard (Lite) RaspberryPi OS. We recommend enabling SSH via RaspberryPi OS imager.
To add Evok repositories and install required modules, connect to your controller using SSH. The username and password for Raspberry Pi OS are set using the Raspberry Pi OS Imager. After you connect to your controller execute the following commands:
sudo su
wget -qO - https://repo.unipi.technology/debian/raspberry-neuron.sh | bash
reboot
sudo su
wget -qO - https://repo.unipi.technology/debian/raspberry-unipi1.sh | bash
reboot
You can proceed to Installing and updating Evok section.
Installing and updating Evok
Make sure you have prepared the OS correctly first. Following steps work both for installing and updating
sudo apt update
sudo apt install -y evok
Tip
If you wish, you can also install or update Evok-web.
sudo apt install -y evok-web
Beta version
Danger
Do not use in production environment, use solely for development. Beta version includes new features. These features may change or be removed during development.
There are several ways of getting beta version.
Switching to the beta repository
To be able use the beta version, you need to have the OS prepared already. You can switch to the beta version of Evok by adding the repository to the apt sources:
echo "deb https://repo.unipi.technology/debian betaevok:bookworm main neuron-main neuron-test test" >> /etc/apt/sources.list.d/unipi.list
apt update
echo "deb https://repo.unipi.technology/debian betaevok:bookworm main patron-main patron-test test" >> /etc/apt/sources.list.d/unipi.list
apt update
echo "deb https://repo.unipi.technology/debian betaevok:bookworm main g1-main g1-test test" >> /etc/apt/sources.list.d/unipi.list
apt update
echo "deb https://repo.unipi.technology/debian betaevok:bookworm main unipi1-main unipi1-test test" >> /etc/apt/sources.list.d/unipi.list
apt update
You can proceed to Installing and updating Evok section.
Installing beta OS image
You can install Unipi image with beta repositories from below. We recommend updating evok after beta image installation, see [Installing and updating Evok] section.
Node-RED OS images
Note
These images have Evok pre-installed.
Base OS images
Uninstallation
sudo apt remove evok evok-web
reboot
Note
After uninstalling Evok, you have to reboot your device to ensure all the files and settings are gone.
Raspberry Pi is a trademark of the Raspberry Pi Foundation