Updated readme for development.

Signed-off-by: Dennis Labordus <[email protected]>

Author: Dennis Labordus

doc/basex.md

@@ -37,6 +37,28 @@ docker run --rm --name compas_basex \
 > **Note:** Replace <BASEX-DIR> with a directory on your local machine, for instance "~/basex".
 > All data will be stored in this directory under "data". This way data isn't lost after stopping the docker container.
 
+### Application depends on a running KeyCloak instance
+
+Beside a BaseX Database there is also a KeyCloak instance need to be running on port 8089 by default.
+See [README.md](../README.md#security) for default values, if custom keycloak is used.
+
+There is a preconfigured keycloak instance available in
+the [CoMPAS Deployment Repository](https://github.com/com-pas/compas-deployment). This repository can be cloned and
+when going to this directory the following command can be executed to create a local Docker Image with configuration.
+
+```shell
+cd <CoMPAS Deployment Repository Directory>/compas/keycloak
+docker build -t compas_keycloak . 
+```
+
+There is now a Docker Image `compas_keycloak` created that can be started using the following command
+
+```shell
+docker run --rm --name compas_keycloak \
+   -p 8089:8080 
+   -d compas_keycloak:latest
+```
+
 ### Building the application
 
 You can run the following command to build the BaseX version of the application.

doc/postgresql.md

@@ -56,7 +56,30 @@ docker run --rm --name compas_postgresql \
 ```
 
 > **Note:** Replace <LOCAL-DATA-DIR> with a directory on your local machine, for instance "~/postgres".
-> All data will be stored in this directory under "compas". This way data isn't lost after stopping the docker container.
+> All data will be stored in this directory under "compas". This way data isn't lost after stopping the docker
+> container.
+
+### Application depends on a running KeyCloak instance
+
+Beside a PostgreSQL Database there is also a KeyCloak instance need to be running on port 8089 by default.
+See [README.md](../README.md#security) for default values, if custom keycloak is used.
+
+There is a preconfigured keycloak instance available in
+the [CoMPAS Deployment Repository](https://github.com/com-pas/compas-deployment). This repository can be cloned and
+when going to this directory the following command can be executed to create a local Docker Image with configuration.
+
+```shell
+cd <CoMPAS Deployment Repository Directory>/compas/keycloak
+docker build -t compas_keycloak . 
+```
+
+There is now a Docker Image `compas_keycloak` created that can be started using the following command
+
+```shell
+docker run --rm --name compas_keycloak \
+   -p 8089:8080 
+   -d compas_keycloak:latest
+```
 
 ### Building the application