Installation Guide

Document reference: GFTCL-INST-001 · Framework: GAMP 5 Category 5 · EU Annex 11

Qualified by: IQ — Installation Qualification

FortressAI Research Institute · Norwich, Connecticut

Patents: USPTO 19/460,960 · USPTO 19/096,071 — © 2026 Richard Gillespie

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

2. Install from the signed DMG (operators)

Production channel: v2 sovereign mesh — GaiaFTCL-v2-Sovereign.dmg via gaiaftcl@gmail.com access code.

1. Request access — receive DMG + signed gftcl2.v1.… envelope (see version.json on apex).

2. Verify integrity before opening:

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

The two values must match exactly.

3. Open the DMG and drag GaiaFTCL into Applications.

4. On first launch, right-click the app and choose Open if Gatekeeper prompts.

5. Mac binding panel — copy hash, paste operator code → Quantum Safe Wallet loads.

!Mac binding panel

!Quantum Safe Wallet

Spec: v2 activation gate.

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 cosignature: pending — gaiaftcl wiki sign --section GAMP5.*