truenas-stacks/docs/reference/HOMELAB_AI_CONTEXT.md

Homelab AI Context Document

This document gives an AI assistant full context of this homelab for infrastructure questions, deployments, debugging, and planning.

See the individual docs in this repo for detailed information:

• Architecture Overview
• Networking Model
• Hardware Inventory
• Services Directory
• Stack Standards
• Deployment Checklist
• Storage Notes
• Backup Policy
• Secrets Management
• Troubleshooting
• Known Quirks
• Serenity
• PlausibleDeniability
• N.O.M.A.D.
• Meshtastic Stack
• Expansion Plan
• TODO

Quick Reference

Communication Preferences

• One command block at a time
• Prefer scripted/automated solutions over interactive multi-step processes
• Uses fresh editor (not nano) on Linux
• Manages remote servers via SSH from Windows 11
• Prefers MariaDB over PostgreSQL for standalone services

Three Servers

Server	Role	OS	IP
Serenity	NAS / Media ingestion	Unraid 7.2.4	10.5.1.5
PlausibleDeniability	Primary Docker host	TrueNAS Scale 25.10.2.1	LAN DHCP
N.O.M.A.D.	Offline knowledge + game servers	Ubuntu 25.10	10.5.1.16

Deployment Pattern (PD)

cd /mnt/docker-ssd/docker/compose/<stack>
docker compose --env-file .env config   # validate first
docker compose --env-file .env up -d    # deploy
docker logs <container> --tail 20       # verify

Network names

• Shared DB network: ix-databases_shared-databases
• Reverse proxy network: pangolin

Storage decision

• Write-heavy / DB / SQLite / GPU → /mnt/docker-ssd/docker/appdata/<service>
• General config / non-fussy → /mnt/tank/docker/appdata/<service>
• Media only → /mnt/unraid/data/media/