How You Run It

• How to add a node to a running fleet

  Adds a node to a running PPN fleet without restarting existing nodes, covering controller health checks, choosing a non-conflicting node ID, and starting its heartbeat agent.

• How to authenticate binary downloads

  Verifies an Ed25519-signed release from the PointSav distribution endpoint using a licence token, the detached signature, and the pinned publisher key before the binary runs.

• How to build a co-location map

  Renders tier-coloured co-location cluster markers on a MapLibre GL map by authenticating against the GIS API and fetching the cluster GeoJSON layer.

• How to configure a tenant namespace

  Configures an isolated tenant namespace: registers the tenant, sets quota limits, issues the root capability token, and verifies isolation and quota enforcement.

• How to configure the Doorman gateway

  Configures a single-instance Doorman gateway — tier upstream addresses, circuit-breaker thresholds, and verifying tier state through the health endpoint and console F9 dashboard.

• How to connect to the OSM data pipeline

  Ingesting a new retail or service chain from OpenStreetMap: write the ingest YAML, run the Overpass query, register the chain in the taxonomy, and rebuild the cluster layer.

• How to deploy a knowledge instance

  Deploys an instance of the app-mediakit-knowledge wiki server from a local content path: build the binary, write knowledge.toml, start the service, and verify it serves pages.

• How to enroll a PPN node

  Enrolls a machine into a PPN compute fleet by verifying the controller, starting the heartbeat agent, and confirming the node in the fleet inventory and WORM ledger.

• How to explore the console for the first time

  Orients a first-time operator to the console — the three-zone layout, status bar fields, Doorman health at F9, and the mandatory F12 input checkpoint.

• How to export structured data from the platform

  Exports platform data through four paths — DataGraph entity records, wiki Markdown, GeoJSON datasets, and tamper-evident ledger tiles — matched to the right layer and format.

• How to federate archives via content mounts

  Federates one knowledge instance's articles into another by declaring a mount in knowledge.toml, restarting the engine, and confirming they resolve without copying files.

• How to install the development toolchain

  Installs the pinned Rust toolchain with rustup, runs a baseline build and tests, and verifies the commit helper and SSH signing key needed before working in a monorepo archive.

• How to issue a capability token

  Issues an Ed25519-signed, time-bounded capability token for a device or service, from selecting the access scope to delivering and verifying the signed credential.

• How to navigate the console TUI

  Navigates the os-console terminal interface by keyboard — switching between F-key slots, reading the status bar for identity and SLM tier, and tracking which slot is active.

• How to open your first Totebox session

  Opens a first Totebox session from a paired device — selecting an archive, reviewing the inbox, starting a BRIEF task, and completing the shutdown sweep before closing.

• How to pair a new device

  Pairs a new device through machine-based authorization — generating a pairing code, cross-checking the hardware fingerprint on a trusted device, and assigning its access tier.

• How to query the DataGraph

  Queries the DataGraph for current entity state with query_datagraph and get_entity_context, navigating relationships, filtering by type, and handling a Tier A circuit outage.

• How to read and write Totebox archives

  Reads a Totebox archive's state at session start — inbox, session context, git status, NEXT.md — and writes changes through the staging-tier commit flow.

• How to read the command ledger

  Reads the append-only command ledger in the F12 Input Machine — interpreting entry types, verifying an entry against its checkpoint hash, and exporting entries as C2SP tlog-tiles.

• How to rotate keys and capability tokens

  Replaces an Ed25519 keypair and its capability token — generating a new keypair, issuing and verifying the new token, then revoking the old one after the transition window.

• How to run local SLM inference

  Starts the local SLM service, verifies Doorman health, and submits inference requests from the console or the API, with all prompt data staying on the deployment.

• How to run your first SLM query

  Opens the F9 SLM cartridge, confirms a live Doorman circuit, and submits a first prompt to the on-premises language model without sending data off the host.

• How to scale user access tiers

  Promotes users across the READ, USER, and INPUT access tiers by issuing new capability tokens and revoking the old ones, including a bulk pass for a whole team.

• How to self-host a deployment

  Provisions a self-hosted deployment instance — installing the verified gateway binary, writing the manifest, starting the gateway, and confirming it reports healthy.

• How to use declarative knowledge mounts

  Adds a secondary content repository to a running knowledge instance through a knowledge.toml mount, serving its articles under a URL prefix after a restart.

• How to use the F-key cartridge model

  Navigates the os-console F-key cartridge model — F3 email, F9 SLM inference, F12 Input Machine — where each compiled-in cartridge owns its slot's rendering and input.

• How to verify a WORM ledger entry

  Verifies a WORM ledger entry by checking its hash chain against the tile files and, where present, a signed checkpoint — using only a standard SHA-256 toolchain.

• Location Intelligence: Data Collection

  Ingesting VWH and PKS chain and infrastructure data into the location-intelligence pipeline from OpenStreetMap — runbook for re-ingesting or extending to new chains and countries.