Skip to main content

Installation

Install

> Release admission classification: internal_only_excluded

jhf-spindle installs as the ERP and business-truth runtime for the Helpifyr stack.

Baseline Bootstrap​

  1. Copy .env.example to .env and set operator-managed values outside git.
  2. Use the canonical Compose stack under infra/compose/docker-compose.yml.
  3. Bootstrap or align the site with the repo-owned scripts.
bash infra/scripts/bootstrap-site.sh
python infra/scripts/align_host_runtime.py --host <internal-runtime-redacted>

Germany Sandbox Tenant Profile​

Use the canonical HERP Germany sandbox profile when you want a repo-owned demo company aligned to the jhf-swatch reference company and the documented finAPI Demobank test tuple.

bash infra/scripts/apply-tenant-setup.sh infra/tenant-setup/herp-de-sandbox.json

Notes:

  • the checked-in profile is now the canonical Germany sandbox initializer for Host172 and sets HERP as the site default company
  • the profile materializes the HERP company, localization, billing address, sandbox bank-account metadata, Germany global defaults, and the anchored 2026 fiscal year in one pass
  • the profile also prunes the legacy multi-company sandbox down to HERP only, which is intended for the test/sandbox lane and must not be used on a production-like shared tenant without a pre-change backup
  • use infra/tenant-setup/jadda-helpifyr-at.json instead when you intentionally need the historic Austria sandbox defaults

Current Live Runtime Ports​

Verified on <internal-runtime-redacted>:

  • Frontend: 18088
  • MCP gateway: 18110

The backend, workers, MariaDB, and Redis remain internal stack services unless explicitly published by the stack contract.

Verify Path​

python -m compileall apps/jhf_spindle_core
python infra/scripts/verify_stack_contract.py --check-running
python infra/scripts/verify_runtime_materialization.py --output artifacts/evidence/runtime-materialization.json
python infra/scripts/verify_accounting_workspace_setup.py --ssh-target <internal-runtime-redacted><internal-runtime-redacted> --expected-company HERP --expected-country Germany --expected-default-company HERP --expected-company-count 1 --expected-fiscal-year-company HERP --expected-bootstrap-user superadmin@helpifyr.com
python maintenance/verify_oss_inventory_version_truth.py --check-live --ssh-target <internal-runtime-redacted><internal-runtime-redacted> --output artifacts/evidence/oss-version-truth.live.json

The accounting workspace verifier is also the canonical owner readback for the HERP sandbox chart-of-accounts summary used by the jhf-swatch Team Finance baseline gate.

Continue with:

License notice: AGPLv3 (GNU Affero General Public License v3.0) Website: https://helpifyr.com