The Revitron Charts app is a frontend for model analytics data that are collected using the revitron analyze command in combination with a Directus instance as the storage. It basically automatically grabs all collections from a Directus instance and auto-generates the respective charts.

Revitron Charts requires a couple of specific environment variables to be defined in order to connect to a running Directus instance and work properly.

Instead of environment variables it is also possible to configure the app using a configuration file with the path config/config.php relative to the root of this repository. Note that there is already a config/defaults.php file in place that can be renamed and used as a template.

<?php

return array(
    'RC_API_KEY' => 'XXX',
    'RC_API_URL' => 'https://url/to/directus',
    'RC_DISPLAY_UNIT' => 'meter'
);

The easiest way of getting the charts dashboard up and running is to use Docker, since no further setup of a webserver that handles PHP files is required. However it is required to be familiar with hosting Docker containers in a local network.

In order to build the Docke image, simply clone it into some temporary directory and use the build command.

git clone https://github.com/revitron/revitron-charts.git .
docker build -t revitron/charts .

After successfully building the image, we can now run it and pass the required environment variables:

docker run -d \
           -p 80:80 \
           -e RC_API_KEY="XXX" \
           -e RC_API_URL="https://url/to/directus" \
           -e RC_DISPLAY_UNIT="meter" \
           --name revitron \
           revitron/charts