Setup and usage

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.

You can run it in any platform (e.g GNU/Linux, Windows, MacOS). The following installation process has been tested on Windows and Ubuntu 22.04 using Docker V26.1.2

Quick start: Setup and Installation using Docker

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

In order to move on, please clone the repository

Note

On Windows OS is important to clone the repository with the original line endings, in particular the .sh files needs to end with LF and not CRLF (see https://github.com/geosolutions-it/digital-twin-toolbox/issues/23)

git clone -c core.autocrlf=false https://github.com/geosolutions-it/digital-twin-toolbox

Navigate in the cloned digital-twin-toolbox repository

cd ./digital-twin-toolbox

Checkout to the latest release

git checkout v1.0.0-rc2

Start the application with

docker compose up

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

Build images locally

The docker compose up command pulls the latest images from the registry. If you want to build the frontend and backend images locally run the following command:

docker compose build frontend backend