matt/echo6-docs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
echo6-docs/vault/INDEX.md
Matt Johnson 44f0257376 docs: migrate Authentik (SSO keystone) to edge2 CT 105 
- Authentik -> edge2 CT 105 (Postgres pg_dump/restore; SECRET_KEY carried verbatim; zero-downtime until ~2s cutover)
- Multi-block Caddy cutover: auth.echo6.co + notes.echo6.co outpost/forward_auth -> 100.64.0.36:9000
- runbook: add reboot tailscale-before-docker gotcha; clarify dnsmasq must NOT be repointed (points at Caddy host)
- source left stopped + intact on Contabo as cold rollback

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-18 05:49:07 +00:00

4.9 KiB
Raw Blame History

type title updated
index Echo6 Knowledge Base 2026-06-17

Echo6 Knowledge Base

The map of this vault — start here. docs/ is current reference, runbooks/ is how-to procedures, projects/ is living context for active work, notes/ is loose operational notes, and archive/ is the historical paper trail.

[!tip] How to use this Click any link to jump to that note. Each note shows its backlinks (what points to it) at the bottom — including this index — so you can always get back home. The graph view (left ribbon) shows how it all connects.

🧭 Reference — current state (docs/)

Infrastructure

  • environment — Proxmox cluster, VMs, LXCs, Headscale nodes, SSH access
  • ip-allocation — full 192.168.1.x IP allocation table (LXCs, VMs, hosts, Meshtastic nodes, Tailscale IPs)
  • services — full services inventory by server (ports, compose paths, access URLs)
  • ots-setup — OpenTAKServer on CT 109 (native install, MQTT gateway, Meshtastic integration, troubleshooting)
  • usenet — SABnzbd + Usenet providers & indexers

Software / platforms (docs/software/)

  • authentik — SSO: OAuth2 providers, groups, flows, branding, enrollment
  • caddy — reverse proxy (Contabo + utility), dnsmasq split DNS, GoDaddy records, port map
  • dns — GoDaddy DNS script, managed domains, common patterns
  • recon — RECON knowledge-extraction pipeline (architecture, stack, API)
  • searxng — Echo6 Search homepage (theme, config, deploy)
  • geo-tools — cortex geo-processing tools (GDAL, tippecanoe, pmtiles)

Matrix / Signal (docs/matrix/)

navi (docs/navi/)

  • cc-rules — Claude Code rules for working on navi
  • deployment — navi build/deploy (VM 1130, nginx, Caddy route, rollback)
  • themes — navi theme system (registry, namedTheme rule, CSS vars)

🛠️ Procedures (runbooks/)

📦 Projects (projects/)

Living "read-me-first" context for active work:

🗒️ Notes (notes/)

⚙️ Baseline & rules

  • CLAUDE-baseline — the global Claude Code rules (read-only mirror of ~/.claude/CLAUDE.md)
  • rules/ — per-system conventions (docker, proxmox, caddy, tak, meshtastic, …) — read-only mirror of ~/.claude/rules/

🔄 Session resume (session-resume/)

Live handoffs for sessions paused on one machine and resumed on another (cross-machine ~/.claude sync is parked). Tagged #session-resume; status: open = not yet finished.

  • SESSION-HANDOFF-meshai-test — paused: pulling MeshAI (CT 108) logs to see how it handled the aida-nebra radio drop. Blocked from matt-desktop (no SSH key on utility); resume on cortex. #open

🗄️ Archive

Historical material lives in archive/ — paper trail, not living docs:

  • archive/projects/ + archive/reports/ — completed one-time deploy logs and migration reports
  • archive/matrix/ — the Matrix-archive investigation saga: the rejected Hookshot path and the PHASE6_DECISION decision record
  • archive/AUDIT-2026-02-21.md — the Feb 2026 doc-vs-infra audit