Installation Guide¶

Document reference: GFTCL-INST-001 · Framework: GAMP 5 Category 5 · EU Annex 11 Qualified by: IQ — Installation Qualification

The controlled procedure for installing and commissioning the GaiaFTCL vQbit Quantum VM. Completing this guide and passing IQ constitutes a qualified installation.

1. System requirements¶

Requirement	Specification
Operating system	macOS 26.0+ (`LSMinimumSystemVersion`)
CPU	Apple Silicon (arm64) — M-series
Memory	16 GB minimum; capacity scales with unified memory (≈1 M cells/algorithm at 128 GB)
Disk	~1 GB for the app + growing append-only substrate store
Toolchain (build-from-source only)	Swift 6.2+, Xcode Command Line Tools
Network	Outbound to the federation mesh (NATS) and, for chain observation, operator-configured RPC

2. Install from the signed DMG (operators)¶

Download GaiaFTCL.dmg from the gaiaftcl.com apex.

Verify integrity before opening:

shasum -a 256 ~/Downloads/GaiaFTCL.dmg
curl -s https://gaiaftcl.com/downloads/GaiaFTCL-latest.dmg.sha256

The two values must match exactly.

Open the DMG and drag GaiaFTCL into Applications.
On first launch, right-click the app and choose Open to clear Gatekeeper.
The vQbit VM boots the substrate and the C⁴ rail comes online.

3. Build from source (engineers)¶

cd cells/xcode
bash scripts/build_sovereign.sh        # builds Franklin.app + the DMG

Franklin.app is the single entry point; VQbitVM and FranklinConsciousnessService are bundled as child subsystems on the internal NATS bus.

4. Commission the configuration¶

Create the operator configuration under ~/.gaiaftcl/ before first operational use. The daemon refuses to start if required configuration is absent — this is correct, not an error. See the Configuration Specification for every file and field. Minimum set:

franklin_sovereign_authority_bounds.toml — Franklin's bounded authority
substrate_tunables.toml — substrate tunable values
cell_federation_context.toml — federation identity / mooring

5. Post-installation qualification (IQ)¶

Run the in-app qualification (⬡ → Run Qualification… in Franklin.app, or the SovereignQualificationRunner). IQ confirms, with no running stack required:

Franklin sovereign binary active; VQbitVM and FranklinConsciousnessService bundled;
NATS live on 127.0.0.1:4222; substrate schema valid (GRDB);
algorithm catalog complete; S4DeltaWire frozen at 53 bytes.

A passing IQ (all checks CALORIE) is the gate to operational use. Full criteria: IQ — Installation Qualification.

6. Verify the install operationally¶

gaiaftcl franklin status          # daemon PID, cadence, tunable state
gaiaftcl cell identity            # cell id + federation context public key
gaiaftcl franklin show-state      # Franklin's substrate-wide state projection

Re-run IQ after any DMG re-install, macOS upgrade, or toolchain update (see Operational Procedures → change control).

Federation-cosigned

This page's source is sealed in the GaiaFTCL federation manifest — page SHA-256 074ccc5ba4d086fb…, manifest witness a090592e0609adc8…, signed 2026-06-02T18:58:22Z by cell gaiaftcl-mac-cell. Verify with gaiaftcl wiki sign --all and compare wiki-all-signatures.json.