Skip to main content

Configuration

Documentation Map​

Configuration

This page is the short canonical map for repo-owned runtime and contract inputs.

Primary Sources​

  • compose.yaml
  • .env.example
  • config/runtime/port-policy.json
  • config/runtime/runtime-materialization-policy.yaml
  • config/keycloak/realms/helpifyr-template.json
  • config/clients/*.yaml
  • config/identity/*.yaml

Runtime Ports and Host Binds​

  • HEADDLE_HTTP_PORT
  • HEADDLE_MANAGEMENT_PORT
  • PLANE_OIDC_HOST_BIND_IP
  • PLANE_OIDC_HOST_PORT
  • LOOM_OIDC_HOST_BIND_IP
  • LOOM_OIDC_HOST_PORT
  • AGENT_RECONCILE_API_PORT
  • AGENT_RECONCILE_WORKER_PORT

Keycloak and Database Runtime​

  • KC_BOOTSTRAP_ADMIN_USERNAME
  • KC_BOOTSTRAP_ADMIN_PASSWORD
  • KC_DB_*
  • POSTGRES_*

Fabric / Projection Consumption​

  • FABRIC_BASE_URL-style validator arguments
  • AGENT_RECONCILE_FABRIC_*
  • Fabric consumer contracts under config/fabric/*.yaml

Bridge and Runtime Verification Inputs​

  • PLANE_OIDC_*
  • LOOM_OIDC_*
  • KEYCLOAK_*
  • AGENT_RECONCILE_MODE
  • AGENT_RECONCILE_RESTORE_SWEEP_VERIFIED
  • AGENT_RECONCILE_APPLY

Verify Path​

python scripts/validate-admitted-surface-client-contracts.py --admitted-surfaces config/clients/admitted-surfaces.v1.yaml
python scripts/validate-identity-claim-vocabulary.py --contract config/identity/claim-vocabulary.v2.yaml
python scripts/verify-runtime-materialization-drift.py
python scripts/verify-runtime-materialization-drift.py --live-host <internal-runtime-redacted> --ssh-user administrator --remote-repo-path /home/administrator/jhf-heddle

License: AGPLv3
Project: https://helpifyr.com