thalos-web/docs/runbooks/containerization.md

Containerization Runbook

Image Build

docker build -t agilewebs/thalos-web:dev .

Local Run

docker run --rm -p 8080:8080 \
  -e API_BASE_URL=http://host.docker.internal:8080 \
  -e THALOS_AUTH_BASE_URL=http://host.docker.internal:20080 \
  -e THALOS_DEFAULT_RETURN_URL=https://auth.dream-views.com/ \
  -e THALOS_ALLOWED_RETURN_HOSTS=auth.dream-views.com,localhost \
  -e THALOS_DEFAULT_TENANT_ID=demo-tenant \
  --name thalos-web agilewebs/thalos-web:dev

Runtime Configuration Strategy

• Build-time fallback: VITE_API_BASE_URL
• Runtime override: container env API_BASE_URL
• Runtime file generated at startup: /runtime-config.js
• OIDC login context is configured via runtime env, not build-time hardcoding.

Health Check

curl -f http://localhost:8080/