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	Check that the license key was issued by Presswerk and has not expired