In order to install the Graivo Coordinator you will need the file and access to a Linux server that runs docker.

The file contains an environmental building tool and can be downloaded from your Asteria online account under “Downloads”:

In this example, we use an Ubuntu Linux server which is hosted on Amazon as an EC2 with a fixed IP address. More specifically, we recommend an Ubuntu 18.04 OS instance with 2 vCPUs and 4GB or more memory. The EC2 instance is set up with a domain so it can be accessed from the public internet at all times.

Copy the to your server and extract it. In this example, we assume that you have extracted the ZIP file to the /home/ubuntu folder.

$ unzip

Next we install the Docker environment.

Installing the Docker environment

Please follow the instructions from Docker to install the Docker Environment on your Ubuntu machine.

Ideally, you run Gravio on the latest Docker version.

Now ensure that you have the latest packages required:

$ sudo apt-get update

$ sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg-agent \

Once that's done, add the Docker official GPG key:
$ curl -fsSL | sudo apt-key add -

Then check the fingerprint: 
$ sudo apt-key fingerprint 0EBFCD88

Next, specify a stable repository
$ sudo add-apt-repository \
   "deb [arch=amd64] \
   $(lsb_release -cs) \

And finally, install the Docker Engine: 
$ sudo apt-get update
$ sudo apt-get install docker-ce docker-ce-cli

Once Docker is installed, check the version of Docker installed

@$ sudo docker --version@

The output would look similar to this:

@Docker version 19.03.10, build 9424aeaee9@

Now install Docker-Compose
$ sudo curl -L "$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
$ sudo chmod +x /usr/local/bin/docker-compose

Note: Please check the Docker site for the latest version of docker-compose and replace the highlighted version string (in this case 1.28.5) above accordingly.

To check the installed version, enter the command

$ sudo docker-compose --version

which will return something along the lines of

docker-compose version 1.28.5, build xxxxxxxx

Now, it’s time to install the Coordinator.

Installing the Coordinator

Move to the directory where you extracted the file:

$ cd coordinatorsetup2.1

Give execute persmissions to the file in that directory:

$ chmod 755

Execute it and set the environment variables required:

$ sudo ./

Launching the Coordinator

Start your coordinator using the docker-compose command:

$ sudo docker-compose up -d

Once the Coordinator is launched, you can access the website on the domain/IP. The first time you access the website, you will see the account creation page. Please follow the instructions to complete your setup.

Stopping the Coordinator

Stop Coordinator using the docker-compose command:

$ sudo docker-compose down

Setting up the SSL Certificate for the Gravio Coordinator

To establish encrypted and trusted connections to the Gravio Coordinator, you need to set up the respective trusted SSL certificates from VeriSign etc:

Using Third Party SSL Certificates

Move to the directory where the certificates are:

$ cd hubkitrepo/coordinator/cert

You will find:

coordinator.crt The Certificate File
coordinator.key The Key File

You can overwrite those files with the files obtained from your certificate issuer.

Using Self-Signed SSL Certificates

When you install the Gravio Coordinator, a self-signed certificate is set by default.

Port Filtering on the EC2 Instance

To ensure communication, please ensure that ports for HTTPS (443) and HTTP (80) are open. These are required to access the web interface. Also, open the port 8082 when using the Coordinator in a debug environment, however we strongly recommend you also enable IP whitelisting for access to your Coordinator ports to prevent unauthorised access.

Important Note: Please ensure that all unused ports are closed on your server using appropriate security measures such as a firewall and/or IP whitelisting.

Port Filtering of Gravio HubKit

To enable the HubKit Log view from the Gravio Coordinator, please also open the access to the port 29442 of your HubKit.

Was this helpful?

Yes No
You indicated this topic was not helpful to you ...
Could you please leave a comment telling us why? Thank you!
Thanks for your feedback.