UI for Magistrala IoT Agent in Elm

Dashboard made with elm-bootstrap.

Install

Docker container GUI build

Install Docker and Docker compose, cd to Magistrala ioT Agent root directory and then

docker-compose -f docker/docker-compose.yml up

if you want to launch a whole Magistrala docker composition, or just

docker-compose -f docker/docker-compose.yml up ui

if you want to launch just GUI.

Native GUI build

Install Elm and then run the following commands:

git clone https://github.com/mainflux/agent
cd agent/ui
make

This will produce index.html in the ui directory. Still in the agent/ui folder, enter

make run

and follow the instructions on screen.

NB: make does elm make src/Main.elm --output=main.js and make run executes elm reactor. Cf. Makefile for more options.

Configuration

Open the src/Env.elm file and edit the values of the env record.

Contribute to the Agent UI development

Follow the instructions above to install and run GUI as a native build. In src/Env.elm change a url field value of the elm record to http://localhost:80/ (trailing slash / is mandatory). Instead of make run you can install elm-live and execute elm-live src/Main.elm -- --output=main.js to get a live reload when your .Elm files change.

Launch Magistrala without ui service, either natively or as a Docker composition. If you have already launched Magistrala as a Docker composition, simply cd to Magistrala folder and run docker-compose -f docker/docker-compose.yml stop ui. Please follow the guidelines for Magistrala contributors.