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:22080 \
  -e THALOS_DEFAULT_RETURN_URL=http://localhost:22080/callback \
  -e THALOS_DEFAULT_TENANT_ID=demo-tenant \
  -e THALOS_ENABLE_MANUAL_LOGIN=false \
  --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 callback defaults are injected through runtime env vars, not hardcoded per build.
• Manual fallback login should remain disabled for deployed auth hosts unless an explicit dev/test override is required.

Health Check

curl -f http://localhost:8080/