narrow highway · setup

Operator setup checklist.

What this instance has running and what it doesn't. means configured. means available but not yet wired up by you. Each row links to the recipe for filling that slot.

configured
optional / unset
engine version
health

Engine substrate

the four gates and the audit chain — always-on by design

/identity Canonical doctrine on every agent-facing surface. Always available. Edit src/concordance_engine/__init__.py · view
/llms.txt AI-agent discovery surface — doctrine + endpoint inventory. view
/ledger SHA-256 chained audit log. The well's content layer. view · integrity check
/chain/since Federation endpoint — peers can concordance fetch from this instance. view

Substrate channels you can opt into

each is independent — turn on one, none, or all

tor onion Engine reachable at a .onion address that survives DNS hijacking + ISP blocks. set CONCORDANCE_TOR_ONION · recipe
email-in Forward an email address; body becomes a seed. set CONCORDANCE_EMAIL_INBOUND · recipe
telegram bot Allow-listed Telegram capture bot. set CONCORDANCE_TELEGRAM_HANDLE + run telegram_bot.py with token
lora mesh Compact wire packets over license-free sub-GHz radio (Meshtastic). set CONCORDANCE_LORA_FREQ + run meshtastic_bridge.py
nostr publication Publish sealed precedents to Nostr relays. set CONCORDANCE_NOSTR_NPUB · run nostr_publish.py as cron
ipfs pinning Content-addressed durable distribution via local ipfs daemon. set CONCORDANCE_IPFS_GATEWAY · run ipfs_pin.py sync
mailing list digest Email digest of newly-sealed precedents to a subscriber list. set CONCORDANCE_MAILING_LIST · run digest_mail.py as cron
/speak — voice ElevenLabs TTS proxy. Returns audio/mpeg in the configured voice. set both ELEVENLABS_API_KEY + ELEVENLABS_VOICE_ID
peer registry path Durable list of known peer instances for cross-node trust sync. Defaults to data/peers.json. set PEER_REGISTRY_PATH (optional override)
trust index directory Per-domain JSON files accumulating independent instance confirmations. Defaults to data/trust_index/. set TRUST_INDEX_DIR (optional override)
offline queue directory Durable retry queue for verifications attempted while offline. Defaults to data/offline_queue.jsonl. set OFFLINE_QUEUE_DIR (optional override)
instance key path Ed25519 keypair for packet signing and instance identity. Auto-generated on first boot at ~/.concordance/instance_key.json. set CONCORDANCE_KEY_PATH to override location
fetch upstream A remote engine this instance pulls precedents from. set CONCORDANCE_FETCH_REMOTE · run concordance fetch as cron

External assets you bring

these aren't environment variables — they're physical or installed

meshtastic (pip) Required for the LoRa bridge. The engine ships the wire format; the bridge needs the radio driver. pip install meshtastic + USB serial radio (~$30 hardware)
pynostr (pip) Required for Nostr publication. pip install pynostr
ipfs daemon Required for IPFS pinning. Runs separately from the engine. brew install ipfs / apt install kubo + ipfs daemon
tor Required for the onion service. Runs separately from the engine. brew install tor / apt install tor + edit torrc