Install

Documentation Map

• Overview

• Quick Start

• Installation

• Configuration

• Operations

• Troubleshooting

• Release Notes

• Compatibility

• Channel: latest

• Source repo: JaddaHelpifyr/jhf-spindle

Install

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>

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 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

Continue with:

• Configuration
• Operations
• Runbook

---

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