79 lines
3.8 KiB
Markdown
79 lines
3.8 KiB
Markdown
|
|
---
|
||
|
|
type: index
|
||
|
|
title: Echo6 Knowledge Base
|
||
|
|
updated: 2026-06-15
|
||
|
|
---
|
||
|
|
|
||
|
|
# 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, 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, IP allocation, Headscale nodes, SSH access
|
||
|
|
- [[services]] — full services inventory by server (ports, compose paths, access URLs)
|
||
|
|
- [[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)
|
||
|
|
|
||
|
|
**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/`)
|
||
|
|
|
||
|
|
- **Authentik:** [[authentik-oidc-application]] · [[authentik-access-groups]] · [[authentik-create-invitation]] · [[authentik-upgrade]]
|
||
|
|
- **Exposing a service:** [[expose-service-contabo]] · [[expose-service-home]]
|
||
|
|
- **Proxmox / hosts:** [[ct-runbook]] · [[proxmox-create-ubuntu-vm]] · [[proxmox-onboard-node]] · [[pi-nas-omv-runbook]]
|
||
|
|
- **RECON:** [[recon-operations]] · [[recon-service-integration]]
|
||
|
|
- **Mesh / Meshtastic:** [[meshtastic-sidecar-node]] · [[meshtasticd-sim-nodes-runbook]] · [[idahomesh-bridge-setup]] · [[idahomesh-vpn-device-setup]] · [[meshmonitor-password-reset]]
|
||
|
|
- **PeerTube / media:** [[add-peertube-channel]] · [[peertube-remote-runner]]
|
||
|
|
- **Internet Archive:** [[ia-cli-reference]] · [[ia-download-mirror]]
|
||
|
|
- **Patterns & infra:** [[pipeline-patterns]] · [[pg-backup]] · [[nordvpn-lxc]] · [[syncthing-add-node]] · [[mailcow-create-mailbox]]
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 📦 Projects (`projects/`)
|
||
|
|
|
||
|
|
Living "read-me-first" context for active repos:
|
||
|
|
- [[advbbs-project]] — advBBS Meshtastic federated BBS
|
||
|
|
- [[mmud-project]] — MMUD mesh dungeon game
|
||
|
|
- [[deploy-livesync]] — Obsidian LiveSync (CouchDB + JWT) reference
|
||
|
|
- [[matrix-synapse-deployment]] — Matrix Synapse + Element + SSO
|
||
|
|
- [[meshtastic-headscale-runbook]] — IdahoMesh Headscale + bridge
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 🔎 Discovery / reference notes (root)
|
||
|
|
|
||
|
|
- **Matrix / Signal lineage:** [[synapse]] · [[mautrix_signal]] · [[archivist]] · [[matrix_host]] · [[appservices]] · [[synapse_retention_discovery]] · [[archivist_discovery]]
|
||
|
|
- **Hookshot** (rejected — decision in [[PHASE6_DECISION]]): [[hookshot_deployment_discovery]] · [[hookshot_e2ee_discovery]] · [[hookshot_payload_discovery]] · [[hookshot_room_targeting_discovery]] · [[archive_receiver_discovery]]
|
||
|
|
- **Other:** [[argus]] · [[ia-download-queue]] · [[echo6-landing-page-data-export]] · [[PLAN]]
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## ⚙️ 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/`
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 🗄️ Archive
|
||
|
|
|
||
|
|
Historical deploy logs, one-time reports, and the Feb 2026 audit live in `archive/` — kept as a paper trail, not living documentation.
|