Installation

Mosquitto, Streamsheets and the Management Center are all available for Windows, Linux and macOS. In addition it also can be installed on a Raspberry Pi.

Installation#

The easiest way to install any of Cedalos products individually, as a bundle or the whole platform is to use the official Docker based installer image cedalo/installer, which is available at Docker Hub.

The installer will guide you through the installation process and will allow you to select which components you want to install: Eclipse Mosquitto, Eclipse Streamsheets, the Management Center or combinations of it.

The following sections describe how to do the Docker based installation on Windows, Linux and macOS.

Windows#

This section describes how to install Eclipse Mosquitto, Eclipse Streamsheets and the Management Center under Windows.

Step 1: Install Docker#

If you have not yet, install Docker for Windows (see installation instructions here).

Step 2: Use the installer#

For an installation under Windows use the installer image tagged with 2-win:

docker run -it -v C:\cedalo_platform:/cedalo cedalo/installer:2-win

In the following dialog you can select (using the space bar) which components should be installed:

? Select what to install › - Space to select. Return to submit
◉ Management Center for Eclipse Mosquitto
◉ Eclipse Streamsheets
◉ Eclipse Mosquitto 2.0
◯ Eclipse Mosquitto 1.6

When you have selected the components to install, press the return key, which will start the installation process. During the installation process the following files will be created within the installation directory:

C:\cedalo_platform
├── docker-compose.yml # Docker Compose file
├── mosquitto #
│ ├── config # Configurations for Mosquitto
│ ├── data # Data directory for Mosquitto
├── start.bat # Start script
├── stop.bat # Stop script
├── streamsheets #
│ ├── init.json # Configuration for Streamsheets
├── update.bat # Update script

Step 3: Start everything#

To start everything you installed, just use the start.bat file.

cd C:\cedalo_platform
start.bat
info

If this is the first time you start the applications, Docker will first perform several downloads (i.e., Docker images) that are required for the application to run.

caution

Please do not close the terminal, in which you executed the start command. If you close the terminal, the applications will be stopped.

Step 4: Open the applications#

When everything is installed and started correctly the applications should be available under the following URLs:

Linux#

This section describes how to install Eclipse Mosquitto, Eclipse Streamsheets and the Management Center under Linux.

Step 1: Install Docker#

If you have not yet, install Docker for your Linux platform (see installation instructions here). For example, Docker is available for Centos, Debian, Fedora or Ubuntu.

Step 2: Use the installer#

For an installation under Linux use the installer image tagged with 2-linux:

docker run -it -v ~/cedalo_platform:/cedalo cedalo/installer:2-linux

In the following dialog you can select (using the space bar) which components should be installed:

? Select what to install › - Space to select. Return to submit
◉ Management Center for Eclipse Mosquitto
◉ Eclipse Streamsheets
◉ Eclipse Mosquitto 2.0
◯ Eclipse Mosquitto 1.6

When you have selected the components to install, press the return key, which will start the installation process. During the installation process the following files will be created within the installation directory:

~/cedalo_platform
├── docker-compose.yml # Docker Compose file
├── mosquitto #
│ ├── config # Configurations for Mosquitto
│ ├── data # Data directory for Mosquitto
├── start.sh # Start script
├── stop.sh # Stop script
├── streamsheets #
│ ├── init.json # Configuration for Streamsheets
├── update.sh # Update script

Step 3: Start everything#

To start everything you installed, just use the start.sh file.

cd ~/cedalo_platform
sh start.sh
info

If this is the first time you start the applications, Docker will first perform several downloads (i.e., Docker images) that are required for the application to run.

caution

Please do not close the terminal, in which you executed the start command. If you close the terminal, the applications will be stopped.

Step 4: Open the applications#

When everything is installed and started correctly the applications should be available under the following URLs:

macOS#

This section describes how to install Eclipse Mosquitto, Eclipse Streamsheets and the Management Center under macOS.

Step 1: Install Docker#

If you have not yet, install Docker for macOS (see installation instructions here).

Step 2: Use the installer#

For an installation under macOS use the installer image tagged with 2-macos:

docker run -it -v ~/cedalo_platform:/cedalo cedalo/installer:2-macos

In the following dialog you can select (using the space bar) which components should be installed:

? Select what to install › - Space to select. Return to submit
◉ Management Center for Eclipse Mosquitto
◉ Eclipse Streamsheets
◉ Eclipse Mosquitto 2.0
◯ Eclipse Mosquitto 1.6

When you have selected the components to install, press the return key, which will start the installation process. During the installation process the following files will be created within the installation directory:

~/cedalo_platform
├── docker-compose.yml # Docker Compose file
├── mosquitto #
│ ├── config # Configurations for Mosquitto
│ ├── data # Data directory for Mosquitto
├── start.sh # Start script
├── stop.sh # Stop script
├── streamsheets #
│ ├── init.json # Configuration for Streamsheets
├── update.sh # Update script

Step 3: Start everything#

To start everything you installed, just use the start.sh file.

cd ~/cedalo_platform
sh start.sh
info

If this is the first time you start the applications, Docker will first perform several downloads (i.e., Docker images) that are required for the application to run.

caution

Please do not close the terminal, in which you executed the start command. If you close the terminal, the applications will be stopped.

Step 4: Open the applications#

When everything is installed and started correctly the applications should be available under the following URLs:

Raspberry Pi#

Coming soon

Installation via npx#

Coming soon