Skip to content

02 Build & Run

Jump to bottom
SimoLoca edited this page May 10, 2022 · 5 revisions

Requirements

The platform runs on a Linux machine with the Ubuntu 20.04.4 LTS version installed. In order to simplify its deployment, the only requirement is Docker.

Installation

Preliminary operation

Before to run the app, you can change the IP address on which the application will be exposed.

Nginx here act as a Reverse Proxy, routing clients to the specific service they are asking for, thus, on <YOUR_IP:YOUR_PORT> is hosted the Platform while on <YOUR_IP:YOUR_PORT>/pignoletto/login the Backend.

Therefore, to serve the application on a different IP, you only need to change LIZMAP_PORT variable in Pignoletto_platform_Docker/src/Makefile.

Another suggested, but not mandatory, operation is to change some values contained in Pignoletto_platform_Docker/src/pignoletto/pignoletto/config.json, especially values like:

  • SECRET_KEY
  • USERNAME
  • PASSWORD

Beware, change in this values need to reflect in the Pignoletto_platform_Docker/src/docker-compose.yml.

Build

Once you have set your IP, you need to create some environment variables, to do so you just need to position yourself in the src/ folder and run the following command:

make env

Run

Next, you just need to run the Docker stack:

docker-compose up [-d]

Open your browser at http://<YOUR_IP>:<YOUR_PORT> for Lizmap Map management (default is: http://127.0.0.1:8080).

Open your browser at http://<YOUR_IP>:<YOUR_PORT>/pignoletto/login for Pignoletto's platform (default is: http://127.0.0.1:8080/pignoletto/login).

API, instead, is active on http://<YOUR_IP>:<YOUR_PORT>/pignoletto/api/v0.1/ (default is: http://127.0.0.1:8080/pignoletto/api/v0.1/).

Previous Section: Home

Next Section: Project Structure

Clone this wiki locally