Skip to main content

Configuration

Purpose​

This page is the canonical v1.6 configuration entrypoint for jhf-loom.

It points to the repo-owned truth for runtime, profile, boundary, and drift-sensitive settings without duplicating the deeper contract docs.

Primary Config Surfaces​

  • .env.example
  • compose.yml
  • compose.low-cpu.yml
  • config/runtime/runtime-contract.json
  • config/runtime/alfresco-runtime-profile.json
  • config/runtime/alfresco-component-family.json
  • config/runtime/runtime-materialization-contract.json
  • maintenance/oss-inventory.json
  • maintenance/oss-version-truth.json
  • maintenance/oss-upgrade-policy.json

Runtime Profiles​

  • default shared-host profile: low-pressure, bounded diagnostics
  • optional healthcheck profile: dedicated-fast only when explicitly enabled
  • heavy profile remains gated by preflight on undersized hosts

Drift-Sensitive Config Areas​

  • compose/env checksum gate for repo-owned runtime changes
  • live stack .env hydration from repo-owned non-secret defaults
  • secret placeholder values in .env.example must be replaced in the operator-owned .env before runtime use
  • non-default metadata keystore passwords require a matching host-managed keystore artifact at runtime-secrets/alfresco/extension/keystore/keystore
  • generate that artifact reproducibly with bash scripts/generate-metadata-keystore.sh --env-file .env; the script reads the two existing metadata password keys without printing them and runs the pinned JCEKS operation in a disposable eclipse-temurin:17-jre container
  • live container labels, mounts, ports, and app readback parity
  • component-family and OSS version truth consistency

The low-idle overlay must override the repository service's complete JAVA_OPTS chain. Docker Compose resolves interpolation before it merges service environments, so setting JHF_LOOM_REPO_JAVA_HEAP_OPTS only inside the overlay would not change the already-rendered Alfresco JVM command. The canonical overlay expression is ${JHF_LOOM_REPO_LOW_IDLE_HEAP_OPTS:--Xms448m -Xmx896m}; verify the rendered command with docker compose ... config before any runtime apply.

Run This Check​

python scripts/validate_docs_platform_v1_6.py
python scripts/validate_runtime_materialization_drift.py
python scripts/validate_oss_inventory_truth.py

Supporting Deep-Dive Docs​

  • Alfresco Runtime Profile (docs/ALFRESCO_RUNTIME_PROFILE.md)
  • Stack Contract (docs/STACK_CONTRACT.md)
  • OSS Inventory
  • Runtime and Service Flows (docs/RUNTIME_SERVICE_FLOWS.md)

License: AGPLv3.

Helpifyr: https://helpifyr.com