StreamPipes Compose is a simple collection of user-friendly docker-compose
files that easily lets gain first-hand experience with Apache StreamPipes.
NOTE: We recommend StreamPipes Compose to only use for initial try-out and testing. If you are a developer and want to develop new pipeline elements or core feature, use the StreamPipes CLI.
docker-compose up -d
Go to http://localhost to finish the installation in the browser. Once finished, switch to the pipeline editor and start the interactive tour or check the online tour to learn how to create your first pipeline!
Tested on: macOS, Linux, Windows 10 upwards (CMD, PowerShell, GitBash)
macOS and Windows users can easily get Docker and Docker-Compose on their systems by installing Docker for Mac/Windows (recommended).
NOTE: On purpose, we disabled all port mappings except of http port 80 to access the StreamPipes UI to provide minimal surface for conflicting ports.
We provide several options to get you going:
docker-compose.yml
.docker-compose.nats.yml
.docker-compose.full.yml
.docker-compose.quickstart.yml
. The Quickstart mode is a user-friendly feature which comes with predefined example assets like pipelines, dashboards, and data views. These ready-to-use components allow first-time users to get a feel of StreamPipes in IIoT with ease, serving as a practical demonstration of how StreamPipes can be utilized for efficient monitoring and analysis. We highly recommend first-time users to begin with the Quickstart mode to understand the simplicity and convenience that StreamPipes brings to the IIoT platform. Please follow the User Guide for Quickstart Mode if you want to explore it.:::info
Other options include configurations for the internally used message broker. The current default is Kafka
, but you can also start StreamPipes with Nats
, MQTT
or Apache Pulsar
. Use one of the other provided docker-compose files.
:::
Starting the default option is as easy as simply running:
NOTE: Starting might take a while since
docker-compose up
also initially pulls all Docker images from Dockerhub.
docker-compose up -d # go to `http://localhost` after all services are started
After all containers are successfully started just got to your browser and visit http://localhost to finish the installation. Once finished, switch to the pipeline editor and start the interactive tour or check the online tour to learn how to create your first pipeline!
Stopping the default option is similarly easy:
docker-compose down # if you want to remove mapped data volumes, run: # docker-compose down -v
Starting the nats option is almost the same, just specify the docker-compose.nats.yml
file:
docker-compose -f docker-compose.nats.yml up -d # go to `http://localhost` after all services are started
Stopping the nats option:
docker-compose -f docker-compose.nats.yml down
Starting the full option is almost the same, just specify the docker-compose.full.yml
file:
docker-compose -f docker-compose.full.yml up -d #go to `http://localhost` after all services are started
Stopping the full option:
docker-compose -f docker-compose.nats.yml down #docker-compose -f docker-compose.nats.yml down -v
Starting the quickstart option:
docker-compose -f docker-compose.quickstart.yml build script-runner docker-compose -f docker-compose.quickstart.yml up -d #go to `http://localhost` after all services are started
Stopping the quickstart option:
docker-compose -f docker-compose.quickstart.yml down
To actively pull the latest available Docker images use:
docker-compose pull
To upgrade to another StreamPipes version, simply edit the SP_VERSION
in the .env
file.
SP_VERSION=<VERSION>