Skip to content

📘 The Continuity Handbook (Read Me First)

Target Audience: AI Agents & System Administrators Purpose: Rapid context injection for network management.

🚨 Critical Mandates

  1. Do Not Reboot: memory-alpha (192.168.1.13) runs critical orchestration. Check active jobs (ps aux | grep rsync) before rebooting.
  2. Storage Standard: All nodes MUST mount storage at /mnt/vault. Do not use legacy paths like /mnt/media.
  3. Permissions: NFS storage requires GID 3000 (media). Local users MUST be added to this group to write data.

🔑 Access & Identity

  • User: vivianl (UID 1000) is the primary admin user on all nodes.
  • SSH Key: Located at ~/.ssh/id_ed25519.
  • Sudo: Passwordless sudo is configured on most nodes. If prompted, check Bitwarden (Human interaction required).

🗺️ Fleet Overview (The "Big Three")

  1. Risa-Mediacore (192.168.1.21):
    • Role: Media & Gateway (Plex, Immich, Pi-hole).
    • Hardware: i5-8500T (QuickSync).
  2. Starfleet-Compute (192.168.1.35):
    • Role: Business & Backups (Nextcloud, Paperless, Downloads).
    • Hardware: i7-3720QM (Threads + Storage).
  3. Memory-Alpha (192.168.1.13):
    • Role: Management (Ansible, Docs).
    • Status: Being depopulated. Moving services to Risa/Starfleet.

📂 Data Topology

  • The Vault: 192.168.1.100:/mnt/TheWarpCore/vault
    • /media - Movies, TV, Books.
    • /downloads - Incomplete/Complete Torrents.
    • /app_data - Docker volumes.
  • Local Brain: /opt/docker_data on each node stores active configs.

🔄 Recovery Protocol

If you (the Agent) crash or lose context: 1. Read This File. 2. Read SUMMARY.md for active project status. 3. Check docs/logs/ for the latest daily log. 4. Verify Network: Run tools/fleet_check.sh (to be created) to ping nodes.