Installing on a Raspberry Pi¶
Streamsheets can be installed on a Raspberry Pi (we recommend model 3B+ or higher). If not already done, set up your Raspberry Pi with the operating system Raspian (Stretch or higher). If you don´t know how to do this follow the instructions in Installing Raspian.
In order to install Streamsheets you need to follow 3 steps: Install Docker, set up Docker Compose and, then, deploy the Streamsheet Platform.
Before starting the installation process, we recommend updating your system, followed by a reboot:
sudo apt-get update
sudo apt-get upgrade
sudo reboot
Fast Install Streamsheets¶
We have prepared a script, which will install everything you need to run Streamsheets. This script installs python3-pip, docker and docker-compose and downloads the Streamsheet images on to your Pi. At the end of the installation process you will be asked if you want to start Streamsheets. This is recommended. If you want to install Streamsheets step by step, go to Manually Install Streamsheets.
Open your shell and enter the following command to start the installation process:
curl -fsSL raw.githubusercontent.com/cedalo/streamsheets-installer/master/pi-installer.sh -o get-streamsheets.sh && sh get-streamsheets.sh
Now you are able to open Streamsheets from anywhere in your network, by typing in the IP-adress/hostname of your Pi together with the port 8081. The standard Raspberry Pi hostname is “raspberrypi”, which results in:
Standard hostname adress: raspberrypi:8081
Open a browser on another computer in the same local network and type the address. On first usage you will have to accept the license agreement, before you can login to Streamsheets. The standard username and password is:
Login:
User:
admin
Password:1234
We strongly suggest changing the password after your first login.
Hint
Streamsheets is designed to run on a Raspberry Pi, but we don´t recommend designing Stream Machines over the same device. Please connect to the Streamsheets application with another device over your browser.
Stopping & Starting Streamsheets¶
Stopping Streamsheets:
Navigate to your shell where the application is running and simply pressctrl + c
.Starting Streamsheets:
Navigate into the folder “~/cedalo” with your shell or with the file manager.If you are using the shell: entersudo sh start.sh
.If you are using the filemanager: double click the start.sh file and run it in the terminal.
Manually Install Streamsheets¶
An alternative to the fast install script. Click here to Show/Hide manual
Setting up Docker
To run Streamsheets you need Docker 18.09 or higher. To set up Docker on a Raspberry Pi, use the following command:
sudo curl -fsSL get.docker.com -o get-docker.sh && sh get-docker.sh
Check the installation by running the following command:
docker -v
Create a docker account and login with:
sudo docker login
Setting up Docker Compose
To install Docker Compose on a Raspberry Pi, run the following commands:
sudo apt-get update
sudo apt-get install -y python python-dev libffi-dev libssl-dev build-essential
sudo pip install docker-compose
Check the installation by running the following command:
docker-compose -v
Setting up Streamsheets
In order to install Streamsheets first create a target folder for the installation. Choose between manually add the folder or just navigate to your prefered dircetory in your shell and use:
Command:mkdir <PATH_TO_INSTALL_DIRECTORY>
Example:mkdir ~/cedalo
Next run the following command to execute the installer for Streamsheets. Replace
<PATH_TO_INSTALL_DIRECTORY>
with the name of the installation directory and<VERSION>
with the Streamsheets version to install (current version: 2.0-milestone).Command:sudo docker run -v <PATH_TO_INSTALL_DIRECTORY>:/streamsheets cedalo/streamsheets-installer:<VERSION>-rpi
Example:sudo docker run -v ~/cedalo:/streamsheets cedalo/streamsheets-installer:1.5-rpi
Navigate into the following directory:
Command:cd <PATH_TO_INSTALL_DIRECTORY>
Example:cd ~/cedalo
This directory contains several shell scripts (and Docker Compose files) to run predefined configurations of Streamsheets.
Starting Streamsheets
To start the default configuration, run the following command:
sudo sh start.sh
Now you are able to open Streamsheets from anywhere in your network, by typing in the IP-adress/hostname of your Pi together with the port 8081. The standard Raspberry Pi hostname is “raspberrypi”, which results in:
Standard host name adress: raspberrypi:8081 Open a browser on another computer in the same local network and type the address. On first usage you will have to accept the license agreement, before you can login to Streamsheets. The standard username and password is:
Login:
User:
admin
Password:1234
We strongly suggest changing the password after your first login.
Welcome to the family. 😊