/verapdf-webapp-server

Back end server for the veraPDF web application

Primary LanguageJavaGNU General Public License v3.0GPL-3.0

Backend for veraPDF web application

Build application

Prerequisites

JDK 11, Maven, Docker

Build sources

You can use your local Maven installation to build project sources:

mvn clean install

Alternatively you can use a docker maven image. For that you need first initialize the volume to re-use maven repo between runs:

.bin/init.sh

After that you can use .bin/build-all.sh script to run actual building.

Running in Docker

Run service stack

cd .docker
docker-compose up -d

Available service endpoints

To check service availability you can request service status endpoints described in API Reference

Stop service stack

cd .docker
docker-compose down

Dev environment

When working on new features it is useful to be able to launch individual services in your IDE directly. To use your local services you can start the stack with PROFILE=dev environment variable:

cd .docker
env PROFILE=dev docker-compose up -d

This will launch the nginx proxy with alternative configuration pointing to your services instead of those from containers.

Config assumes that you launch services on the following ports:

  • file storage service: 8090
  • jobs service: 8091

API Reference

https://github.com/veraPDF/verapdf-webapp-server/wiki/API-Reference