Installing a Node using Docker-compose

Prerequisites

You have a platform that supports the minimum requirements:

• Docker is installed
• Docker Compose is installed

1. Login to registry.crosser.cloud

Open a terminal and enter:

[sudo] docker login https://registry.crosser.cloud

When prompted, enter the username and password which you find in the Docker Credentials section on the Register Node tab on the Nodes page (you have to enable Advanced Settings to see this).

2. Get docker-compose.yml

To be able to use docker-compose you need a configuration file. Download the file docker-compose.yml into a local folder, or copy the content below into your own docker-compose.yml

services:
  edgeNode:
    image: registry.crosser.cloud/node/edgenode:latest
    container_name: crosser-edgeNode
    restart: always
    environment:
      - SecurityConfiguration__Credentials__NodeId=ENTER-YOUR-NODEID-HERE
      - SecurityConfiguration__Credentials__AccessKey=ENTER-YOUR-ACCESS-KEY-HERE

      #Increase log level (optional)
      #- EdgeNodeConfiguration__LogLevel=Debug
    ports:
      - 9090:9090
      - 9191:9191
      - 1883:1883
    volumes:
      - "./data:/application/data"
      #Map certificate bundle from host (optional)
      #- "/etc/ssl/certs/ca-certificates.crt:/etc/ssl/certs/ca-certificates.crt:ro"
    logging:
      driver: json-file
      options:
        max-size: "50m"
        max-file: "2"

3. Set Credentials

3.1 With NodeId and AccessKey

Replace ENTER-YOUR-NODEID-HERE and ENTER-YOUR-ACCESS-KEY-HERE in your docker-compose.yml file with the values you got when registering the Node above.

3.2 With Global key (only for mass deployment)

In the docker-compose.yml file replace these two lines:

- SecurityConfiguration__Credentials__NodeId=ENTER-YOUR-NODEID-HERE
- SecurityConfiguration__Credentials__AccessKey=ENTER-YOUR-ACCESS-KEY-HERE

with these lines:

- SecurityConfiguration__Registration__Key=ENTER-YOUR-GLOBAL-KEY-HERE
- SecurityConfiguration__Registration__Name=UNIQUE-NAME-HERE

Then replace ENTER-YOUR-GLOBAL-KEY-HERE with the global registration key you, or your administrator, generated and replace UNIQUE-NAME-HERE with the name you want to give the Node (only alphanumeric characters and underscore are allowed in Node names).

4. Start the Node

Run this command from the folder where you created the docker-compose.yml.

[sudo] docker-compose up -d

The Node will be downloaded from the docker registry and started.

5. Ready to go

If no errors were reported your Node is now up and running and connected to Crosser Control Center (check that you have a green checkmark next to the Node on the Nodes or Dashboard pages).

Next, start to build and deploy some flows on your new Node.

Good luck!