Monitoring

Health Endpoints

Endpoint	Description
/api/actuator/health	Overall health status
/api/actuator/health/liveness	Kubernetes liveness probe
/api/actuator/health/readiness	Kubernetes readiness probe

Health checks include: database connectivity, Keycloak reachability, disk space, license status.

curl http://localhost:8080/api/actuator/health

Logs

# All services
docker compose logs -f

# Application only
docker compose logs -f app

# Keycloak only
docker compose logs -f keycloak

# Database only
docker compose logs -f postgres

Troubleshooting

Issue	Solution
App won’t start	Check docker logs presswerk-app — common: DB not ready, wrong credentials
Can’t log in	Verify Keycloak is running and KEYCLOAK_PUBLIC_URL is reachable from browser
Health shows DOWN	Ensure Keycloak is accessible from the app container
Scheduled reports fail	Check SMTP config in .env, verify connectivity
License invalid	Ensure LICENSE_PUBLIC_KEY matches the key used to sign the license