4.0 KiB
4.0 KiB
nuclide.systems — Infrastructure Docs
Central documentation for the nuc Proxmox homelab and all hosted services.
Source of truth: /docs/ on the Proxmox host (192.168.1.20).
This directory is the entry point — docs generated anywhere else should land here.
Infrastructure
| File | Contents |
|---|---|
| proxmox-optimizations.md | Full audit, sizing decisions, action log, pending tasks |
Docker Stacks (CT 104 / 192.168.1.40)
Service docs (stacks/docs/)
| File | Contents |
|---|---|
| homelab-architecture.md | Overall architecture overview |
| mcp-gateway.md | MCP gateway design and endpoints |
| mcp-gateway-requirements.md | MCP gateway requirements |
| zoraxy-setup.md | Zoraxy reverse proxy setup notes |
| AdGuard-DNS-writes.md | AdGuard DNS rewrite rules |
| comfyui-mcp.md | ComfyUI MCP integration |
| dev-environment.md | CT 111 Coder + Gitea dev platform |
| traefik-migration.md | Traefik → Zoraxy migration notes |
| traefik-migration-docker-labels.md | Label mapping reference |
| cloud-gpu-extension.md | Cloud GPU burst setup |
| scrubbing-list.md | Services to clean up / decommission |
| stack-ideas.md | Backlog of stack ideas |
| case-study.md | Case study writeup |
Operational (stacks/)
| File | Contents |
|---|---|
| PORTMAP.md | Port assignments for all services |
| storage.md | Volume and storage layout |
| volumes.md | Docker volume inventory |
| docker-networks.md | Docker network topology |
| todo.md | Outstanding stack tasks |
| CLAUDE.md | Agent breadcrumbs (migrated stacks, dormant services) |
Nexa Project (stacks/nexa/)
| File | Contents |
|---|---|
| README.md | Project overview |
| docs/01-vision-and-scope.md | Vision and scope |
| docs/02-roadmap.md | Roadmap |
| docs/03-architecture.md | Architecture |
| docs/04-integration-matrix.md | Integration matrix |
| docs/05-command-system.md | Command system |
| docs/06-classification-logic.md | Classification logic |
| docs/07-workflow-spec.md | Workflow spec |
| docs/08-graphrag-architecture.md | GraphRAG architecture |
| docs/09-deployment.md | Deployment |
| docs/10-operations.md | Operations |
| docs/11-open-questions.md | Open questions |
| docs/12-optimization-opportunities.md | Optimization opportunities |
| docs/13-information-wishlist.md | Information wishlist |
AI Agents (stacks/ai/)
| File | Contents |
|---|---|
| home-info.md | Home context for agents |
| morning-briefing-agent.md | Morning briefing agent config |
| PROMPTING-2026.md | Prompting guide 2026 |
Contributing
- Drop new docs in the appropriate subdirectory
- Update this README when adding a new section
- When CT 109 (management LXC) is built, the docs platform will serve this directory