Local development

DB Changes with FlyWay

1. Make your changed in
   backend/src/main/resources/db.migration
2. Start a Dockerized DB
   docker run --rm --name postgres_schema -e POSTGRES_USER='develop' -e POSTGRES_PASSWORD='develop' -e POSTGRES_DB='develop' -p 4321:5432 postgres:14-alpine
3. Run gradle
   ./gradlew generateJooq

Testcontainers

To fully enable the "withReuse"-Feature you have to add this line to the .testcontainers.properties-File in your home directory (created after the first testRun):

testcontainers.reuse.enabled=true

Browser preparation

Chrome

Until Keycloak is updated you have to:

1. Go to chrome://flags/
2. Search for "Samesite"
3. Disable "SameSite by default cookies" and "Cookies without SameSite must be secure" flags.
4. Relaunch.

OSM Request Trust Certificate

Valid until: 15. Sep 2025 18:00:00 CEST

Handle truststore.jks

List truststore Certs:

cd backend/src/main/resources
keytool -list -keystore truststore.jks
keytool -list -v -keystore truststore.jks

Renew Root Cert in TrustStore

1. Download new Cert \\ From: Let's Encrypt (Take Active -> Let’s Encrypt R3 Cert in the "der" format)

2. installing the Cert \\

   cd backend/src/main/resources
   rm truststore.jks
   keytool -import -keystore truststore.jks -storepass Tester11 -noprompt -trustcacerts -alias LetsEncryptR3CrossSigned -file ~/Downloads/lets-encrypt-r3-cross-signed.der
   keytool -import -keystore truststore.jks -storepass Tester11 -noprompt -trustcacerts -alias LetsEncryptR3 -file ~/Downloads/lets-encrypt-r3.der
   

Elasticsrach connection

Add the Certs generated by Elasticsearch to the KeyStore:

keytool -import -v -trustcacerts -file ./deploy/localDev/boxit/elasticsearch/certs/ca/ca.crt -alias elasticsearch_ca_cert -keystore ./backend/src/main/resources/truststore.jks
keytool -import -v -trustcacerts -file ./deploy/localDev/boxit/elasticsearch/certs/elasticsearch/elasticsearch.crt -alias elasticsearch_cert -keystore ./backend/src/main/resources/truststore.jks

Artifacts

• LogoFont
  https://www.1001freefonts.com/remachine-script.font
  If definitely used... it also needs a license