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.

The Raspberry Pi Streamsheet version is free to use for private and education use only. For any other purpose or any other operating system use we offer a commercial version. Please contact us for further information and prices.

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 accpet the license agreement, before you can login to Streamsheets. The standard username and password is:

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.

Starting/Stopping Streamsheets

Stopping Streamsheets:
Navigate to your shell where the application is running and simply press ctrl + c.
Starting Streamsheets:
Navigate into the folder ~/cedalo/streamsheets/scripts either with your shell or with the file manager.
If you are using the shell: enter 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. Show/Hide manual

  1. 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

  2. Check the installation by running the following command:

    docker -v

  3. Create a docker account and login with:

    sudo docker login

Setting up Docker Compose

  1. 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
  2. Check the installation by running the following command:

    docker-compose -v

Setting up Streamsheets

  1. 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 ~/streamsheets
  2. 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: 1.3).

    Command: sudo docker run -v <PATH_TO_INSTALL_DIRECTORY>:/streamsheets cedalo/streamsheets-installer:<VERSION>-rpi
    Example: sudo docker run -v ~/streamsheets:/streamsheets cedalo/streamsheets-installer:1.3-rpi
  3. Navigate into the following directory:

    Command: cd <PATH_TO_INSTALL_DIRECTORY>/streamsheets/scripts/
    Example: cd ~/streamsheets/streamsheets/scripts/

This directory contains several shell scripts (and Docker Compose files) to run predefined configiurations 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 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 accpet the license agreement, before you can login to Streamsheets. The standard username and password is:

User: admin Password: 1234 We strongly suggest changing the password after your first login.

Welcome to the family. 😊