Installing on macOS¶

In order to install Streamsheets you need to follow 3 steps: Install Docker, set up Docker Compose and, then, deploy the Streamsheet Platform.

Setting up Docker¶

To run Streamsheets you need Docker 18.09 or higher. To set up “Docker for Mac”, follow the installation instructions.

Setting up Docker Compose¶

Docker Compose is already included in “Docker for Mac”, so there is no separate step necessary.

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 ~/streamsheets
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.6-milestone).

Command: docker run -v <PATH_TO_INSTALL_DIRECTORY>:/streamsheets cedalo/streamsheets-installer:<VERSION>-macos

Example: docker run -v ~/streamsheets:/streamsheets cedalo/streamsheets-installer:1.6-milestone-macos

Starting Streamsheets¶

Navigate into the install directory:

Command: cd <INSTALL_DIRECTORY>

Example: cd ~/streamsheets

This directory contains several shell scripts (and Docker Compose files) to run predefined configurations of Streamsheets.
To start the default configuration, run the following command:

Command: sh start.sh

The web interface for Streamsheets is locally available under: http://localhost:8081/ or in the local network under <your_ip_adress>:8081 (e.g. 192.168.178.90: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. 😊