Note: This guide explains how to configure a SORMAS server on Linux and Windows systems for development. Please note that there is no database setup because the script supposes the use of the Docker Postgresql image (see SORMAS-Docker).
See Installing Java
SORMAS just recently moved to Java 11. We still need to support Java 8 for a transition period. Therefore, please just use Java 8 language features for now.
Download and install Ant, it can be done from Ant site or with packages from your Linux distribution.
Alternatively you can use the Docker image available in SORMAS-Docker repository.
Install you own Payara server (see installing SORMAS Server) or run bash ./server-setup-dev-docker.sh
This script will download Payara (if needed) and install SORMAS in the Payara server.
You can edit this script to change paths and ports.
Other steps :
- IMPORTANT: Adjust the SORMAS configuration for your country in /opt/domains/sormas/sormas.properties
- Adjust the logging configuration in
${HOME}/opt/domains/sormas/config/logback.xmlbased on your needs (e.g. configure and activate email appender) - Build and deploy applications (ear and war) with you IDE.
See Keycloak for how to install Docker locally.
If you are doing active development on Keycloak (themes, authentication mechanisms, translations, etc.) it's recommended to install the standalone variant.
To enable VAADIN Debug Mode, go to sormas-ui/src/main/webapp/WEB-INF/web.xml and set productionMode to false.
Make sure not to commit your changes to these files, for example by using .gitignore. To access the debug Window, got to /sormas-ui/?debug. You may need to log in as admin once first.