Skip to content

Setup and usage

stefano bovio edited this page May 17, 2024 · 10 revisions

Prerequisites

A Docker instance installed on the selected working machine is needed in order to install and run this toolbox. From the official documentation Docker is described as an open platform for developing, shipping and running applications and it is possible to find documentaion on how setup Docker Engine at this link.

Basics

The goal of this page is to instruct the users on how run the toolbox locally in order to process raw data and generate 3D Tiles dataset.

In order to move on, please clone the repository

git clone https://github.com/geosolutions-it/digital-twin-toolbox

Navigate in the cloned digital-twin-toolbox repository

cd ./digital-twin-toolbox

Copy the .env.sample and rename it to .env, this file include the default variable to initialize the application

Start the application with

docker compose up

After the docker containers are running is possible to access the client at: http://locahost:3000

Environment variables

The toolbox application allows to customize some enviroment variables by editing the .env file. Here below a list of aviable variables with description:

name description default
DEVELOPMENT if true enable the watch listener to rebuild the client and server on file changes false
NGINX_PORT editing this value changes the webapp url port 3000