trinimon/dictionary-service repository overview

⁠Dictionary Service

This repository contains a Java Spring Boot service image designed to run alongside the dictionaries Docker image. It provides two REST endpoints:

• translations between English ⇄ German and Spanish ⇄ German
• a “Word of the Day” feature available in Spanish, English, and German

⁠Running with Docker

Running in Docker with security and CORS disabled.

docker run -p 8080:8080 \
    -e SPRING_DATASOURCE_URL=jdbc:postgresql://localhost:5432/dictionaries \
    -e SPRING_DATASOURCE_USERNAME=translator \
    -e SPRING_DATASOURCE_PASSWORD=secret \
       trinimon/dictionary-service

In order to enable security add:

SECURITY_ENABLED=true
KEYCLOAK_ISSUER_URI=<scheme>://<host>:<port>/realms/<realm>
OAUTH2_AUDIENCE=<audience>

CORS can be configured for instance by:

CORS_ENABLED=true
CORS_ALLOWED_ORIGINS=http://<hostname>:<port>,http://<ip>:<port>

⁠Technologies

• Java 25
• Spring Boot 4
• PostgreSQL
• Docker