Skip to main content

Install Data Orchestrator

To get our Data Orchestrator instance running as fast as possible, we will install Data Orchestrator's standalone distribution. It includes a tunable Docker Compose which brings up Data Orchestrator and every companion service needed for it to work. To do so, simply clone Data Orchestrator's main repository and use its scripts to bring it up:

$ git clone https://github.com/astarte-platform/astarte.git -b v1.3.1 && cd astarte
$ docker run -v $(pwd)/compose:/compose astarte/docker-compose-initializer:1.3.1
$ docker compose pull
$ docker compose up -d

docker-compose-initializer will generate a root CA for devices, a key pair for Housekeeping, and a self-signed certificate for the broker (note: this is a really bad idea in production). You can tune the compose file further to use legitimate certificates and custom keys, but this is out of the scope of this tutorial.

Compose might take some time to bring everything up, but usually within a minute from the containers creation Data Orchestrator will be ready. You can reach Data Orchestrator at the following addresses:

  • api.astarte.localhost: Data Orchestrator API, in detail:
    • api.astarte.localhost/appengine: AppEngine
    • api.astarte.localhost/housekeeping: Housekeeping
    • api.astarte.localhost/pairing: Pairing
    • api.astarte.localhost/realmmanagement: Realm Management
  • broker.astarte.localhost: VerneMQ broker
  • dashboard.astarte.localhost: Data Orchestrator Dashboard

Moreover, Compose will forward the following ports to your machine:

  • 80: HTTP
  • 8883: MQTTS

To check everything went fine, use docker ps to verify relevant containers are up: Data Orchestrator itself, VerneMQ, CFSSL, RabbitMQ and ScyllaDB should be now running on your system. If any of them isn't up and running, docker ps -a should show it stopped or failed. In those cases, it is advised to issue docker compose up -d again to fix potential temporary failures.