• Java 17 JDK
• Maven 3.8+
• Node 20+
• NPM 9+

1. Create a config subdirectory within the directory you will run the app from
2. Copy example-application.properties into the config directory and rename it to application.properties
3. Are you enabling SAML authentication?
   • If yes:

     1. add the IdP certificate to your config directory

     2. generate/add your SP key and certificate to the config directory. An example using openssl:

        openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout dimsum_sp.key -out dimsum_sp.crt

     3. fill out the SAML properties in application.properties, including paths to the above-mentioned certificates/key

   • If no, add the following line to application.properties to disable authentication: spring.profiles.active=noauth

Maven is configured to automatically run npm to install node modules, compile and package TypeScript via tsc and webpack, and include requirements from both in the Java build.

Build runnable .jar file:

mvn clean package

Or run server via Maven:

mvn clean spring-boot:run

The server runs on port 8080 by default. To run on a different port, add a server.port setting to your application.properties

Prometheus metrics are available at /metrics on the deployed webapp.