moovida/gss repository overview

⁠The GSS

The Geopaparazzi Survey Server application is a webapp that allows users to synchronise project data to a centralized server using the devices as surveyors.

The mobile app able to synchronize with the GSS at the moment is SMASH: https://www.geopaparazzi.org/smash/index.html⁠

⁠How to run the server

⁠From version 3.0xxx on

Since users have been asking for it, from the 3 series onward, the demo docker images will be served working with postgis. This makes the container way larger, but it comes with PostGIS, so it is worth it. :-)

The app has to be run in two steps:

Step 1: run the postgis database

Set the workspace folder:

WORKSPACE=/Users/hydrologis/TMP/GSSSERVER

and then run the db:

docker run  --rm --name=gss-postgis \
-d -v $WORKSPACE:/home/gssworkspace \
-e POSTGRES_USER=test -e POSTGRES_PASS=test -e POSTGRES_DBNAME=test \
-e ALLOW_IP_RANGE=0.0.0.0/0 -e JAVA_OPTS="-Xms1256m -Xmx4g" \
-p 8080:8080 -p 5432:5432 \
-v $WORKSPACE:/var/lib/postgresql \
moovida/gss:v3.0

Some configuration is done also for the webapp (port, memory), which is run in a second instant.

When you are sure that postgis runs, get the ID of the database container and start the webapp.

Step 2: run the webapp

Set the container ID:

GSS_CONTAINER_ID=yourid

and run the app:

docker exec -ti $GSS_CONTAINER_ID java -Xmx1g -jar gss-backbone-3.0.0.jar /home/gssworkspace testPwd jdbc:postgresql://localhost:5432/test

Note that:

• testPwd is the password that will be configured and used by the devices to connect.
• the postgis db was previously run with user and pwd and database name all set to test

That said, you should now be able to access the web app in the browser at port 8080 ( http://localhost:8080⁠ if local).

⁠Before version 3

docker run -v /localpath:/home/basefolder -e JAVA_OPTS="-Xms1256m -Xmx4g -Dstage.globalfolder=/home/basefolder/" -p 8080:8080 moovida/gss:v2.3